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PREFACE 



Developed by Control Data Corporation, the KRONOS operating system is employed by CYBERNET 
Service to provide interactive (conversational) time-sharing and remote batch processing. Accordingly, 



CYBERNET Service offers KEONOS capabilities on CDC 
nationwide data processing network. 



,® 



6400 computer systems maintained in its 



While other manuals deal with batch processing and KRONOS subsystems, this manual focuses on 
KRONOS interactive time-sharing as available through the CYBERNET network. In addition, this 
manual concentrates on reference information as opposed to presenting instructional material for 
beginning users. (For instructional text, see the CYBERNET Interactive Service Time-Sharing 
Tutorial, Pub. No. 86615800.) 

Please note that this service is intended for use only as described in this document. Control Data 
cannot be responsible for the proper functioning of undescribed features or undefined parameters. 

The following manuals contain additional information that pertains to KRONOS processing. 
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The KRONOS Time-Sharing System provides a user with general purpose or specialized 
time-sharing capabilities. It can be used from any location simply by dialing the com- 
puter's telephone number. 

Since KRONOS is capable of serving a large number of users simultaneously, the cost 
of using the system is only a fraction of that of conventional data processing systems. 
This is combined with the speed and convenience of a conversational system. 

Although a large number of users may be accessing KRONOS at the same time, the 
sophisticated software that controls the system assures the complete separation of each 
activity. Thus, each user may conceptually imagine that he is the only user of the 
system. 

To further enhance the convenience of programming, the KRONOS system maintains 
control of all information (files) created by its users. Prior to creating a file, it is 
named and may subsequently be requested by that name at any time. 

The KRONOS system is inherently secure. It assumes that any file created belongs 
exclusively to the person creating it and will deny any other user's request to access 
it. However, a user can also specify that a file be made available to other users. 

In order to use the system, it is necessary to know its telephone number and be able 

+ i*. on v*«^l tt i*]«-i«-t4-*.*'^n^iA** /m^hui n+i«rt *-x +* rt iifinn mi inn l~v *-\ v> «1 »-. /i nv*± innnlln n «^ n n i-*itt j^ vi r3 r* li ■ » *n r* ft 

lu oujjpijr lViSlltii.lv^ctLi.vjil ^Oiiolblliig KJL ex uaci liuiiiuci anu \j^ji.LKjLi.<xj.l.y , a ^aoowuiu, K^llcxi. gc 

number, and project number. After dialing the appropriate telephone number and making 
connection with the computer, the system requests the user indentification. In some 
cases, the terminal being used may also require identification. If the identification is 
legitimate, access to the KRONOS system occurs immediately. 

In summary, the KRONOS system is a powerful, sophisticated time-sharing system 
which can satisfy a wide spectrum of computational needs of its users. Its conversa- 
tional capabilities permit its users to debug their programs much faster than with other 
data processing systems. Its peripheral mass storage and advanced file maintenance 
techniques permit vast amounts of information to be stored at high speeds. The fact 
that the system can be used from terminals in remote locations creates an environment 
in which many users can be performing work in the privacy of their own offices, with- 
out the inconvenience of traveling to the computer site. 

TERMINALS 

All communication with the computer can take place via a remote terminal. Programs 
or data are sent to the computer according to specific rules or commands. The com- 
puter responds by typing its answers on the terminal. If the user attempts to execute 
an incorrect command, the computer rejects the command and prints the reason for 
its rejection. 
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Two types of terminals may be used to communicate with KRONOS. 

• ASCII code compatible terminals (such as Teletype® models 33, 35, 37, 
and 38, Memorex 1240, CDC 713, etc.) 

• Correspondence code terminals (such as Novar 5-41, Datel 30, IBM 2741, 
etc.) 

If a correspondence code terminal is to be used, KRONOS requires that the communi 
cations system equipment be modified to accommodate this type of terminal. In 
addition, modification is also required if transmission speeds greater than ten characte 
per second are required. 



rs 



Most time-sharing operations can be performed using either type of terminal. Differ- 
ences in operation are described, when applicable, throughout this manual. A summary 
of these differences is described in Table B-l of appendix B. 

SUBSYSTEMS 

After identifying himself to the system, the user can specify a subsystem to be used. 
The available subsystems are: 

» BASIC An elementary programming language used for scientific applica- 

tions. This easily learned language is quickly adaptable to the 
needs of engineers, businessmen, educators, and other fields. 
It requires neither computer background nor training in higher 
mathematics. 

• BATCH Provides the user with a batch control card capability from the 

terminal. It enables a user to type control card images at his 
terminal that would normally have to be entered from a card 
reader at the central site or from a remote batch environment. 

» EXECUTE Allows a user to execute a previously compiled program. Since 

a majority of the time spent on a job is for compilation, this 
subsystem provides an efficient means to run a frequently used 
program without having to recompile it each time. 

« FORTRAN Translates mathematical language into machine language to solve 

mathematical and engineering problems. The time -sharing 
FORTRAN subsystem provides a convenient language for expressing 
mathematical and scientific problems and a convenient method for 
data input and output. 

v NULL Allows the user to perform file manipulations and other time-sharing 

operations without subsystem association. 

CONVENTIONS 

Throughout this manual, the following conventions are used. 

# (<CJy denotes the RETURN key on the terminal keyboard. Each line of 
time-sharing terminal input must be followed by a (cm . The system 
responds by performing a carriage return and line ffcecl operation (positions 
carriage to first character position on the next line). 

, The word system refers to the KRONOS Operating System which provides 
the interface between KRONOS and the user's program. 

m The vertical spacing in examples does not necessarily coincide with the 
spacing that will appear on the user's terminal. 
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It is recommended that a new user refer to the glossary to become familiar with 
terms used in this manual and other KRONOS manuals. 
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This section is intended primarily for users unfamiliar with the KRONOS Time-Sharing System. It is 
designed as a guide to be used for the first session at a time-sharing terminal. Included are instruc- 
tions necessary to gain access to the system (log-in), enter and run a simple program in the BASIC 
language, and finally, leave the system (log-off). The user need not be concerned about damaging the 
system by making incorrect entries or other mistakes at the terminal. This type of error will merely 
be detected by the system, which in turn will issue a routine error message to the user's terminal 
(probably ILLEGAL COMMAND), hi general the user is permitted as many attempts as are necessary 
to make a correct entry. However, this is not true for the log-in procedure. If a user fails to log-in 
properly four times in succession, the terminal is automatically disconnected. If this happens, the 
user should recheck the assigned family name, user number, and password, and then start over. 

Most users will access the KRONOS system through Control Data's Data Services Network of remote 
communications concentrators. However, some users, those located in the same city as the KRONOS 
site, will be tied into the system directly, hi a number of instances, this manual distinguishes network 
users from non-network users with respect to particular messages that will be received, or additional 
commands to be employed. 



LOG-IN PROCEDURE 



Check to ensure that the following switches on the terminal are set to the correct position. Do not 
be alarmed if one or more of the switches listed does not exist on the terminal to be used. If the 
terminal has been determined acceptable for KRONOS time-sharing operation, its use should cor- 
respond to that described in this manual. 

• Full-duplex/half -duplex (FDX/HDX) switch - For network users, this switch is set to the half- 
duplex position. Full -duplex operation is not supported for network users. In the full-duplex 
position characters entered from the terminal are not printed. 

• Even parity/odd parity switch - If an ASCII code terminal is being used, this switch must be set 
to even parity. Odd parity must be selected for correspondence code terminals. 

• Baud rate switch - This switch determines the speed at which the terminal transmits and re- 
ceives information. There is only one correct position when the terminal is connected to KRONOS. 
However, this is a system option and is dependent upon the system equipment being used. If you 
do not know the correct setting, see your CDC representative. 

Dial the KRONOS computer site. If the procedure is unfamiliar, refer to Appendix B for complete 
instructions. When the connecting sequence is complete, KRONOS initiates the log-in sequence in 
the following manner. For 10 and 30 cps ASCII terminals a double slash (//) is typed out. Nothing 
is typed out for 14. 8 c ps correspondence r-o^e terminals. 
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3. Identify your terminal to KRONOS as described below. 

• 10 or 30 cps standard ASCII terminals: 

Perform a carriage return 

• 10 or 30 cps APL ASCII terminals: 

r £\mQ t± and then perform a carri no, e return 

• 14. 8 cps correspondence code terminals with standard print: 

Perform a carriage return 

• 14. 8 cps correspondence code terminals with APL print: 

Type A and then perform a carriage return 

The system will then respond by typing out the following: 

NET nnnnnn (This line transmitted to network users only) 

PLEASE SIGN ON— 

where: 

The NET line defines the network address of the port the user has dialed into. This may be ™| 

referenced in the case of sign on problems. 

4. In response to the sign on request the user should enter only the two-character family name that 
has been assigned to his or her family of permanent files and queues . 

For example: 

PLEASE SIGN ON--KC 

Once the user enters a valid family name, the communications network routes the access request to 
the appropriate central KRONOS system. The KRONOS system indicates that access has been es- 
tablished by transmitting the following greeting message: 

yy/mm/dd. hh.mm.ss_. 

center serial number KRONOS version 

where: 

yy /mm /dd. hh. mm .ss. = date and time when communication is established with the central 

system 

center = name of the CYBERNET center being accessed 

serial number = serial number of the central-site computer system 

version = version number that identifies what version of KRONOS is being 
employed at the CYBERNET center in question 
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5. After sending the greeting message, KRONOS then requests that the user supply a user number by 
transmitting: 

USER NUMBER: 
Enter your assigned user number on the current line. 
For example: 

USERNUM: USER123 (CR) 
The system responds by printing: 

PASSWORD 



( 



6. Enter your password in the blacked-out area. 
For example: 



D 



H 



The system responds by printing either: 

TERMINAL: nnn,iii 
RECOVER/CHARGE : 



or 



TERMINAL: nnn.iii 
RECOVER/SYSTEM: 



where: 



m 



Terminal number that the system uses as part of the unique identifier for each 
active user 

Identifier that describes the type of terminal as follows: 



TTY ASCII code terminal with standard print 

MEMAPL Memorex 1240 (ASCII code) terminal with APL print 

CORAPL Correspondence code terminal with APL print 

COR Correspondence code terminal with standard print 

713 CDC 713 Display Terminal 

BLKEDIT Block transmission terminal with full display screen editing 

capability (available only on select terminals such as the Hazeltine 

2000 terminal) 

7. Perform step a or b depending upon which system response was printed in step 6. 

a. If the RECOVER/SYSTEM: response was printed, enter the subsystem to be used on the same 
line (BASIC for this session). 

For example: 

BASIC (CR) 



I 
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The system responds by printing: 

OLD, NEW, OR LIB FILE: 

b. If the RECOVER/CHARGE: response was printed, type CHARGE, followed by your assigned 
charge number and project number on the same line. 

For example: 

CHARGE , chargeno , proj ectno (CR) 
The system responds by printing: 

READY. 
Then enter the subsystem to be used (BASIC for this session). 
For example: 

BASIC (CR) 
The system responds by printing: 

OLD, NEW, OR LIB FILE: 

4 

8. Enter the appropriate file status on the same line (NEW for this session). "' 
For example: 

NEW (cS) 
The system responds by printing: 
FILE NAME: 

9. Enter the name of the file on the same line (PRIME for this session). 
For example: 

PRIME (CR) 
The system responds by printing: 
READY. 



4 
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Up to this point the output at the terminal has the following form. 

// « (Only on 10 and 30 cps ASCII terminals) 

NET nnnnnn < — (Only on network ports) 

PLEASE SIGN ON--KC 

yy/mm/dd. hh. mm, ss . 

EASTERN CYBERNET CENTER SN166 KRONOS 2.1 

USER NUMBER: USER123 

PASSWORD 



A I B I C I D E F GB 4 (The password cannot be seen and is shown in this 



( 



TERMINAL: nnn, iii manner solely for purposes of illustration. ) 

RECOVER/SYSTEM: BASIC 

OLD, NEW, OR LD3 FILE: NEW 

FILE NAME: PRIME 

READY. 



PROGRAM ENTRY AND EXECUTION 

1. Now enter the BASIC program PRIME. Each program statement is followed by a carriage return. 

10 PRINT "THIS IS A LISTING OF TEN PRIME NUMBERS" 

11 PRINT 

20 PRINT "WHICH PRIME THE PRIME NUMBER" 

30 LET N=0 

40 LET V=0 

45 FOR A=l TO 10 

50 LET V=V+1 

60 LET Y=INT(V/2+.5) 

70 FOR X=2 TO Y 

80 LET Z=V/X 

90 LET W=INT(Z) 

100 IF Z=W THEN 50 

110 NEXT X 

120 LET N=N+1 

140 PRINT" ";N," ";V 

160 NEXT A 

170 END 

2. The program is now ready to be executed. Type: 

RUN (CR) 
The system returns the following output: 
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yy/mm/dd. hh.mm.ss. 

PROGRAM PRIME 

THIS IS A LISTING OF TEN PRIME NUMBERS 

WHICH PRIME THE PRIME NUMBER 

1 1 

2 2 

3 3 

4 5 

5 7 

6 11 

7 13 

8 17 

9 19 

10 23 

This program prints the first ten prime numbers. After the program has completed execution, the 
system replies: 

SS s.sss SECS. 
RUN COMPLETE. 

where: 

s. sss Amount of system second time required to execute the program. NOTE: This 

message will not be printed if the job required less than .010 system seconds for 
execution. 



LOG-OFF PROCEDURE 

To leave the system, type: 
BYE (CI 



This command causes the following information to be printed, then logs you off the system by dis- 
connecting the terminal. 

USER123 LOG OFF. hh.mm.ss 
USER123 SS s.sss SEC. 

where: 

s.sss Total system seconds used since log-in. 



C 
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With the exception of some central memory tables, all data in the KRONOS system 
is considered either a file or a part of a file. This section describes the mass 
storage file organization under KRONOS and explains the fundamentals of file processing. 
Refer to the KRONOS Reference Manual for detailed information concerning the KRONOS 
file structure. 

FILE STRUCTURE 

A file is the largest collection of information addressable by name (one to seven I 



I 



characters), and begins with the beginning- of- information (BOI), before which no data 
exists. A file consists of one or more logical records of information. A logical 
record is a group of related words or characters, of fixed or variable length, which is 
independent of its physical environment. Thus, a logical record on punched cards 
would contain the same information as its counterpart on mass storage. 

The physical record unit (PRU) is the smallest division of data on a device. A PRU 
on all mass storage devices in the KRONOS system consists of 640 six-bit characters. 
The logical record is composed of one or more PRUs. 

The end of a logical record is the end-of-record (EOR). The end of a file is the end- 
of- information (EOI). The system automatically writes an EOI as the last physical 
item of information on all files. However, the user may have the additional capability 
to write an end-of-file mark (EOF) to signify the end of a file. This capability exists § 
in the FORTRAN subsystem and in other languages available under the BATCH sub- 
system (COMPASS, COBOL, etc. ). Therefore, due to the EOI concept, a file may 
actually be a multifile file. For example: 

(BOI). . . data. . . (EOR). . . data. . . (EOR)(EOF ). . . data. . . (EOR)(EOF)(EOI) 

A typical file is illustrated by the following example. 

One line of an invoice may form an item, a complete invoice may form a 
record, a set of such records may form a file, and the collection of invoice 
files may form a multifile file. 

To have a file positioned at the BOI means that a subsequent read operation will read 
the first logical record. A write operation writes data on the first PRU and terminates _ 
with an EOR and EOI following the logical record. A file positioned at EOR has the ■ 

following record, EOF, or EOI read on a subsequent read operation. A subsequent 
write operation on the file adds data to a new physical record following the current EOR 
or EOF. A file positioned at EOI is positioned at the last physical record of the file. 
Any subsequent read operation causes the EOI to be read. No data is transmitted. A 
write operation writes over the existing EOI and adds a new logical record to the file 
followed by an EOR and EOI. 
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The following examples illustrate possible positions within a file. 
File 1 ...data...(EOR)(EOF)(EOI) 

a una 

File 2 ... data. . . (EOR). . . data. . . (EOR)(EOF). . . 

e mm 

File 3 ... data. . . (EORXEOI) 

LLJ l£J Lil 

Q] File positioned at BOI 

\2\ File positioned at EOR 

[J] File positioned at EOF 

[|] File positioned at EOI 

WORKING FILES 

Generally, a working file is either a new file, created by the user, or a copy of a 
file that already exists in the system (indirect access permanent filet ). All working 
files are temporary in nature and can exist no longer than the user is logged into the 
system. Working files may be created, accessed, and released at the discretion of 
the user while he is logged into the system but they are automatically released when 
he logs off the system. 

Working files may also be referred to as local files. The parameter lfn on most M 

time-sharing job commands and permanent file commands (described in sections 4 and * 

5) signifies a local file name. Therefore, throughout this manual, the terms are 
synonymous. 

One type of working file, the primary file, has special significance in certain time- 
sharing commands. A primary file is obtained with the OLD or LIBRARY command 
which retrieves a copy of an indirect access permanent file. In addition, a primary 
file is created with the NEW command. There is only one primary file active or 
available to the user at any given time. For example, the command 

OLD, LFN 1 

retrieves a copy of indirect access permanent file LFN1 from permanent file storage 
for use as the primary file. If the command 

OLD.LFN2 

is entered, a copy of indirect access permanent file LFN2 is retrieved for use as the 
primary file, and the current primary file (LFN1) is released. To access LFN1 again, 
the user must enter the OLD command or enter: 

GET,LFN1 

If this command is used, a copy of permanent file LFN1 is retrieved for use as a 
working file and the current primary file (LFN2) remains the same. 



tRefer to section 5 for complete information concerning permanent files. 
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Most operations performed on files by time-sharing terminal commands are performed 
using the primary file, unless another working file is specified in a command para- 
meter. For example, the command 

SAVE 

is used to retain the primary file in the permanent file system. However, the command 

SAVE, ABC 

is used to retain file ABC in the permanent file system. File ABC could be either the 
primary file or another working file. 

There is a close association between the primary file and the subsystem in use when 
the primary file is saved. Unless the NULL subsystem is active when the primary file 
is saved, an internal indicator called the subsystem flag is set to indicate which sub- 
system is being used. That subsystem becomes associated with the permanent file and 
is automatically selected each time the file is retrieved using the OLD command. For 
example, if a user currently operating under the BASIC subsystem issues the command 

SAVE, ABC 

where ABC is the current primary file name, the BASIC subsystem flag will be associated 
with the resulting permanent file ABC. If at a later date the user is operating under 
another subsystem and enters the command 

OLD, ABC 

the current primary file is released, the BASIC subsystem is selected automatically, 
and file ABC becomes the new primary file. To save the primary file without a sub- 
system association, the user must enter the NULL subsystem before issuing the SAVE 
command. Retrieving a file saved while under the NULL subsystem does not affect 
^ the subsystem currently being used. Furthermore, the subsystem flag is set only when 

^ saving the primary file since this is the only working file that has a subsystem asso- 

ciated with it. If the permanent file named in the command to select a new primary 
file (OLD or LIBRARY) does not have a subsystem associated with it, the subsystem 
currently being used remains in effect. 

Following any operation on a primary file, the file is automatically rewound (positioned 
at BOI). However, the user is responsible for the position of all other working files 
because they are not automatically rewound following each operation. The REWIND 
command from a time- sharing terminal, the REWIND statement in FORTRAN, or the 
RESTORE statement in BASIC can be used to position a file to the BOI. 

Information (program statements, text, or data) entered from the terminal keyboard I 

is normally stored in the primary file. However, the user can also enter source code 
into any working file, including the primary file, or create new working files using 
the Text Editor. Refer to the Text Editor (EDIT) Reference Manual for additional 
information. 

FILE SORTING 

Each line of information entered by the user must begin with a line number unless it is 
entered in text mode. A space must appear between the number and the information 
which follows. Line numbers for FORTRAN Extended or BASIC programs cannot be 
more that five digits. All other information can have line numbers up to ten digits. 
Leading zeros on line numbers are permissible but are not required (00120 and 120 are 
interchangeable). Line numbers with leading zeros can be intermixed with line numbers 
containing no leading zeros. Line numbers can be entered manually or may be gener- 
ated automatically by the system. This is accomplished by entering the AUTO command 

, (refer to description in section 4). Note that the line numbers generated by the AUTO 

\ command consist of only five digits. 

t Refer to the TEXT command in section 4 for information concerning text mode. 
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I When the user is not in text mode, entering numbered lines of information sets an internal 
indicator called the sort flag. When the sort flag is set, the primary file is sorted auto- 
matically whenever the LIST, LNH, RUN, REPLACE, RNH, LENGTH, EDIT, SAVE, or 
SUBMIT command is entered. Sorting of the file places the statement in order according to 
the first five digits of the line number. If it is desired to sort the file on more than the first 
five digits, the number of digits can be specified using the SORT, lfn command (NC parameter). 
Refer to description of this command in section 4. 

When entering information from the terminaL the user enters the line number and the 
statement. After the carriage return ( (Ctg ) key is pressed, the text is entered 
into an area in core. Periodically, when this area (16 decimal central memory words) 
is filled, the text is written to the user's primary file on mass storage as a new logical 
record. When a sort is performed, these records are rewritten as one logical record. 
Thus, the entire input is stored as one logical record. 

If the message 

FILE TOO LONG TO SORT. 

is returned to the user, the file is too long to be sorted automatically by the system. 
The user must then enter the SORT, lfn command before proceeding. 

However, if the message 

FILE NOT SORTED. 

is returned to the user, the system has attempted to sort the file but discovered that 
one or more lines begin with a nonnumeric character. Thus, a sort was not performed 
and the sort flag was turned off. The user may enter the SORT, lfn command for more 
informative diagnostics. 

If the user wishes to inhibit automatic sorting of the primary file, he may enter the 
NOSORT command. This command clears the sort flag and should be entered only 
when the user desires that the primary file not be sorted and packed into one logical 
record. The sort flag is reset when KRONOS receives the first numbered line of 
source code following the NOSORT command. 

The following example illustrates the effect of the NOSORT command. The user selects 
the proper subsystem and obtains a copy of permanent file A with the command sequence: 

FORTRAN, OLD, A 

It should be noted that if file A had a subsystem flag other than FORTRAN or NULL 
associated with it, that subsystem would be selected automatically even though the 
user specified the FORTRAN subsystem. To ensure that the correct subsystem and 
file have been selected, the user enters the command: 

STATUS 

The system prints the following status report. 

TERMINAL 42, TTY* Identifies the terminal being used 

SYSTEM - FORTRAN Proper subsystem was selected 

FILE NAME: A- File A is the new primary file 

STATUS - IDLE 

The user then requests a listing of the file with the command: 
LIST 



< 
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The system prints the following copy of the file. 

73/01/10. 16.07.14. 

PROGRAM A 

00100 PROGRAM TEST (OUTPUT) 

00110 DO 1 J=l, 10 

00120 PRINT, J 

00130 1 CONTINUE 

00140 END 

READY. 

The user then enters the following changes: 

00120 K=J*J 

00130 PRINT, K « 

00140 1 CONTINUE 

00150 END 

and enters the commands: 

NOSORT 
READY. 

LIST, R 

The system lists the unsorted file indicating the end of each logical record. 

73/01/10. 16.12.23. 

PROGRAM A 

00100 PROGRAM TEST (OUTPUT) 

0U110 DO 1 J=l, 10 

00120 PRINT, J 

00130 1 CONTINUE 

00140 END 

--EOR-- 

00120 K=J*J 

00130 PRINT, K 

00140 1 CONTINUE 

00150 END 

--EOR-- 

READY. 

If the user had requested a listing without entering the NOSORT command, the following 
output would have been provided. 

00100 PROGRAM TEST (OUTPUT) 

00110 DO 1 J = l, 10 

00120 K=J*J 

00130 PRINT, K 

00140 1 CONTINUE 

00150 END 

If the user wishes to inhibit file sorting, but desires that the file be packed into one 
logical record, he may enter the following command. 

PACK 

If the user then wishes to perform text editing on the packed file, he can call the Text 
Editor with the EDIT command (refer to the description of the EDIT command in section 
4). 
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WORKING FILE CONTROL 
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As mentioned previously, the OLD, NEW and LIBRARY commands change the status 
of files by exchanging the current primary file for another. When the OLD command 
is entered, the primary file is exchange for a copy of an indirect access permanent 
file from the permanent file system. When the NEW command is entered, a new pri- 
mary file is created which the user fills from the terminal. The LIBRARY command 
replaces the current primary file with a copy of an indirect access permanent file saved 
under the special user number LIBRARY. 

It is important to note that normally, when the current primary file is released (by entry 
of the OLD, NEW, or LIBRARY command), all other working files are also released 
when the next command is entered, unless that command is NODROP. The current work- 
ing files..(with the exception of the primary file) are retained if the next command 
entered is NODROP. 

The following is a list of sample commands and their effect on files. The example 
assumes that there is no subsystem association with any file retrieved using the OLD 
command. Therefore, the subsystem to be used must be specified, if other than the 
current subsystem. 



Commands 



BASIC, OLD, A 






A 




GET.B 






A 


B 


GET.C 






A 


B,C 


GET.D 






A 


B,C,D 


FORTRAN, OLD, A 1 






Al 


B,C,D 


RUN (program Al 


creates 


TAPED 


Al 





Files Present at Completion of Command 
Primary Other Working Files 



RUN 



COMPLETE, (system response) 



GET.B1 

GET, CI 

SAVE.TAPE1 

FORTRAN, OLD, A2 

NODROP 

RUN (program A2 creates TAPE2) 



i 



Al TAPE1 

Al TAPE1.B1 

Al TAPE1.B1.C1 

Al TAPEl.Bl.Cl 

A2 TAPEl.Bl.Cl 

A2 TAPEl.Bl.Cl 

A2 TAPEl.Bl.Cl 



RUN COMPLETE, (system response) 



A2 



TAPE1, TAPE2.B1.C1 
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Other commands that change the status of working files are: 

CLEAR Releases all working files. Note that only the contents of 

the current primary file is released; the primary file name 
is retained. If no primary file is currently specified, a new 
primary file name is requested. 

LOGIN Releases all working files 

HELLO Releases all working files 

GOODBYE Releases all working files 

BYE Releases all working files 

Refer to section 4 for a complete description of these commands. 
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SYSTEM COMMANDS 



After the user has successfully logged into the system, he can enter the commands necessary to pro- 
cess his job. There are four general categories of commands available to the user. 

• Terminal control commands 

• Subsystem selection commands 

• Job processing commands 

• Permanent file commands 

With the exception of permanent file commands, each command category is described in this section. 
Permanent file commands are described in section 5. 



COMMAND PROCESSING 

The min imum number of characters required to specify a command depends upon the specific command 
and the subsystem currently being used. A minimum of three characters are checked when a command 
is entered in all subsystems except the BATCH subsystem. In the BATCH subsystem, commands can- 
not be abbreviated. If more than the minimum number of characters are entered, the system checks 
the number given, up to a maximum of seven characters. 

For example, if a user is operating under the BASIC subsystem and wishes to change to FORTRAN, the 
following are legal and illegal commands for entering FORTRAN. 



Legal Forms 


Illegal Forms 


FOR 


F 


FORT 


FO 


FORTR 


FORx (where x is any alpl 


FORTRA 


character except T) 


FORTRAN 





However, if the user is in the BATCH subsystem and wishes to change to any other subsystem, the name 
of that subsystem must be entered without abbreviation. 

In general, KRONOS processes each command by checking from one to seven of the characters entered. 
If the user does not enter a sufficient number of characters to make the command unique, the system 
responds 

COMMAND NOT UNIQUE. 

and the user must then reenter the command using a sufficient number of characters to make it unique. 
This only occurs with commands in which several characters are identical, such as HELP and HELLO. 
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If the command entered is not a valid command or has been misspelled, the message 
ILLEGAL COMMAND. 

is returned. If a user discovers an error in a command entry or other input, prior to performing a 
carriage return, the user may either delete the entire line or backspace to the point of the error, cor- 
rect it, and continue processing on the same line. 

To delete an entire line on an ASCII code terminal either press the CAN key (CTRL X ) ' or the BREAK 
key. On a correspondence code terminal press the ATTN key. The system responds with 

*DEL* 

and then positions the carriage to the first character position of the next line. 

In order to backspace and correct an error, count the number of characters (including spaces) past the 
position of the error and press the backspace key an equal number of times. Then correct the error 
by typing in the proper entry, and continue processing on the same line. On ASCII code terminals 
backspacing is accomplished by pressing a BACKSPACE key, performing a CTRL 11 (simultaneously 
pressing the CTRL and H keys), or in the case of some CRT terminals, pressing a backarrow key. 
On correspondence code terminals backspacing is performed with the BACKSPACE key. 

If the user attempts to perform an operation for which he is not validated or exceeds his validation 
limits, the system responds: 

ILLEGAL USER ACCESS. 

The system maintains validation controls for every user number. Refer to the LIMITS command at the 
end of this section for a complete description. 

Alphabetic characters entered in lowercase are automatically translated to uppercase unless the ASCII 
command is in effect. The ASCII command inhibits translation from lowercase to uppercase (refer to 
the description of the ASCII command). Note that all commands may be entered in uppercase or lower- 
case in either ASCII or non-ASCII mode. 

On all commands that require a numeric value, the number is treated as follows: 

• If the number contains an eight or nine, decimal base is assumed. 

• The base may be specified by a post radix of B or D, that is, 562D is treated as 562 decimal and 
562B is treated as 562 octal. 

• Default conversion of numbers is normally to base octal although this is a system option. 



CTRL X generates the same character as the CAN or CANCEL key. It is performed by simultaneously 
pressing the CTRL and X keys. 



I 
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The terminal control commands allow the user to vary the source and format of information given to 
and received from the system. These commands, which may be entered at any time after the user has 
successfully logged in, are described as follows: 



ASCII 



Specifies that all subsequent characters entered from the terminal be 
translated into the full ASCII code set. The full ASCII code set consists 
of 128 characters. The standard KRONOS code set contains only the 
first 61 of these characters. 



KRONOS recognizes all characters of the full ASCII code set except 
LINE FEED and the ASCII-DEL codes. Input control characters (return, 
delete, and backspace) are recognized but are not translated. Characters 
of the standard code set are processed internally as six-bit display code 
characters. The additional characters which make up the full ASCII code 
set are processed internally as 12-bit display code characters with an 
escape code convention. Refer to Appendix B for an explanation of how 
the system interprets characters in both ASCII and non- ASCII modes. 

The ASCII command must be entered if lowercase letters are to be inter- 
preted as such by the system. Normally, all lowercase letters are 
translated to uppercase. Commands may be entered in uppercase or 
lowercase in either ASCII or non-ASCII mode. 

NOTE: If a correspondence code terminal is being used, the ASCE 
command must be entered to enable use of the full correspondence code 
set. 



AUTO,nn,ii 



Causes KRONOS to generate five-digit line numbers automatically. The 
nn parameter specifies the beginning line number; ii specifies the incre- 
ment value added for each succeeding line number. The user can exit 
from auto mode using either of the following methods . 

1. Delete the current line on ASCII code compatible terminals, depending 
on the particular terminal, either by pressing the BREAK key, the 
CANCEL key, or performing a CTRL X (simultaneously pressing the 
CTRL and X keys). Then enter a new command on the next line. 

The procedure is the same for correspondence code terminals 
excepting that users employ the ATTN key. 

2 . Backspace six character positions and then enter a new command on 
the same line (six backspaces are required to overwrite the five- 
digit line number and the blank that follows). 

It is also possible to alter the line numbering sequence by deleting or 
backspacing (steps 1 or 2) and then entering a new beginning line number 
rather Jhan-a new - comm a n d { lead i ng zeros am permissible but 4iet re- 
quired). The user should exercise caution when doing this since the 
AUTO command is still in effect and continues generating line numbers 



4-3 



f 



using the original increment value. Thus, if a line number is generated 
that already exists in the file, the contents of that line are lost and must 
be entered again to be retained. Note that it is not possible to alter the 
increment value unless a new AUTO command is entered. 

hi the following example of the AUTO command, the user exits the auto 
mode by pressing the BREAK key and then entering an LNH command 
(refer to Time-Sharing Job Commands in this section for a description 
of the LNH command). 

AUTO 

00100 THIS IS A TEST 

00110 FOR THE AUTO COMMAND 

00120 END 

00130 *DEL* 

LNH 

00100 THIS IS A TEST 

00110 FOR THE AUTO COMMAND 

00120 END 

READY. 

In the next example the user employs the BREAK key to change the 
numbering sequence several times. 

NEW.KL ™ 

READY. 

AUTO, 10, 10 

00010 THIS IS A TEST 

00020 FOR THE AUTO COMMAND 

00030 *DEL* 

00100 TEST 

00110 TEST 

00120 *DEL* 

00200 TEST 

00210 END 

00220 *DEL* 

LNH 

00010 THIS IS A TEST 

00020 FOR THE AUTO COMMAND 

00100 TEST 

00110 TEST 

00200 TEST 

00210 END 

READY. 

FULL Enters full -duplex mode. Under this mode, each character received by 

the system is echoed back to the terminal just as it was received. This 
mode is effective only for terminals which have a full-duplex capability. 
The system responds: 

READY. 
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HALF 



If the half/full duplex switch on the terminal is in the half -duplex position 
when this command is entered, each subsequent character entered is 
double printed (initially when it is typed, and again when it is echoed 
back by the system) . Placing this switch in the full-duplex position 
allows only the character echoed back to the terminal to be printed. 

The FULL command is rejected with an ILLEGAL COMMAND message 
for network ports . j 

Clears full-duplex mode (refer to FULL command). Characters received 
by the system after this command is issued are not echoed back to the 
terminal. The system responds: 



NORMAL 



PARITY 



ROUT.nn 



READY. 

If the terminal being used has a half/full duplex switch, characters 
entered at the terminal are not printed when the switch is in the full- 
duplex position. Only system-generated output appears at the terminal. 
Placing this switch in the half -duplex position enables keyboard entry 
to be printed. 

The HALF command is rejected with an ILLEGAL COMMAND message 
for the network ports. 

Reverses the effect of the ASCII, AUTO, PARITY, and TAPE commands. 
KRONOS initially assumes that this command has been entered. Normal 
mode consists of a 6i-character code set where ail lowercase letters are 
converted to uppercase. 

Specifies that all subsequent output to an ASCII code terminal be trans- 
mitted in odd parity, and all output to a correspondence code terminal 
be transmitted in even parity. KRONOS initially assumes that all infor- 
mation is transmitted in even parity to ASCII code terminals and odd 
parity to correspondence code terminals. 

Sets the amount of time required to perform the return function (carriage 
return and line feed) for an ASCH code terminal. This command is not 
valid for correspondence code terminals. The nn parameter specifies a 
character count delay. This is the amount of time required by the sys- 
tem to send nn characters to the terminal, where the value of nn can 
range from to 30. If zero is specified, a standard delay value is used. 
The system responds : 



READY. 

This command is necessary since the length of time required for the 
return operation varies depending upon the type of terminal being used. 
For example, if the system is transmitting output to a terminal, a fixed 
amount of. tme.M,Mlowed for the jetarn. function, after which the sys- 
tem sends the next line of output. If the amount of time is not sufficient, 
characters may be printed during the carriage return function. 
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The delay is accomplished by sending rubout characters for paper tape 
operations and null characters for all other input/output operations. 
The number of characters to be sent is initially set at log-in or re- 
covery time by the system. If a ROUT command is entered, the num- 
ber of characters specified for the delay remain in effect until termin- 
ation of the session (log-off), recovery, or until another ROUT command 
is entered. 



TAPE 



TERM.t 



Permits subsequent information to be read from the paper tape reader 
at an ASCII code terminal. The system sends an X-ON character to the 
terminal at the end of each program request for data and after execution 
of each command. The X-ON character is used to turn on the paper tape 
reader at the user's terminal. This mode also inhibits the output of 
header messages from the LIST command and the READY message after 
the execution of most commands. The user should note that the system 
ignores carriage return characters entered on an empty input line while 
in tape mode. Refer to Appendix C for complete information concerning 
paper tape operations. 

Allows the user to redefine the terminal characteristics that were 
established at log-in. The t parameter specifies the new terminal 
characteristics as follows: 



TIMEOUT 



TTY 
713 
COR 
CORAPL 

ME MAP L 

BLKEDIT 



ASCII code terminal with standard print 

CDC 713 Display Terminal 

Correspondence code terminal with standard print 

Correspondence code terminal with APL print 

Memorex 1240 (ASCII code) terminal with APL 
print 

Block transmission terminal with full display 
screen capability (available only on certain ter- 
minals such as the Hazeltine 2000 terminal). 



The user can change the print type and then indicate the change by means 
of the TERM command. 

For example, a user operating a Memorex 1240 terminal changes the 
print type from standard to APL. To notify the system, he enters: 



TERM.MEMAPL (CR) 



This command may be selected by default, 
entering the LIMITS command. 



This can be checked by 



Changes a "no timeout" terminal to the standard "timeout" status. In 
standard "timeout" status, the user is automatically logged off after 10 
minutes of no action. Standard status is in effect when bit 11 in access 
word AW is clear. (Refer to the LIMITS command in this section. ) 
When the bit is set, the terminal remains connected until the user logs 
off. The TIMEOUT command clears this bit for the session in progress. 



4 
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SUBSYSTEM SELECTION COMMANDS 

The following commands are used to select a specific subsystem. The user should always be aware of 
the subsystem that is currently active. For example, attempting to execute a FORTRAN program while 
operating under the BASIC subsystem causes meaningless diagnostic messages to be issued. To deter- 
mine which subsystem is currently active, enter the STATUS command. 

When a user enters the SAVE command to retain his primary file in the permanent file system, it is 
especially important that he is aware of which subsystem is currently active. An internal indicator 
called the subsystem flag associates the current subsystem with the primary file being saved. Thus, 
each subsequent request for that file using the OLD command causes the associated subsystem to be 
selected automatically. To save the primary file with no subsystem association, the user must enter 
the NULL subsystem before he issues the SAVE command. Note that the subsystem flag has meaning 
only when saving the primary file. When saving working files other than the primary file, no subsys- 
tem association is made. 

BASIC, ccc Selects the BASIC subsystem. The ccc parameter is optional and enables 

the user to specify an additional command. Although any valid command 
is permitted (as well as all valid parameters for that command), only 
one additional command may be specified. The following example 
illustrates the use of this option. 

BASIC, OLD, PRIME 

In this example, the user selects the BASIC subsystem and the OLD file 
PRIME in one command. Note that the file name (PRIME) is a valid 
parameter with the OLD command. 

If ccc is omitted, and no primary file is currently defined, the system 
responds : 

OLD, NEW, OR LIB FILE: 

The user may then specifvthe file type and the file name (separated by 
a comma) followed by a (CR) . If the file name is omitted in the reply, 
the system responds: """' 



^LIB is an abbreviation of the command LIBRARY. Refer to the description of this command later in 
this section. 
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BATCH, nnnnn 



FILE NAME: 

The user then specifies the file name followed by a (CB) . 

Selects the BATCH subsystem. The nnnnn parameter specifies the field 
length in octal central memory words required for control card images 
to be entered. If nnnnn is not specified, a default value of 20000B is 
assumed. The system responds: 



i 



$RFL, nnnnn. 

/ 



(nnnnn is the specified field length) 



The user may then enter control card images, time-sha ring commands, 
or both for the job. Refer to the KRONOS Reference Manual for infor- 
mation concerning control cards. 



ENQUIRE, options 



It is important to note that the time-sharing commands and control card 
images entered are not processed as a batch job, as the subsystem 
name implies. Instead, each control card or command is entered and 
processed individually. The subsystem is named BATCH because images 
of control cards, usually referred to as batch control cards, are able to 
be processed. Refer to section 9 for a complete description of the 
BATCH subsystem. 

The ENQUIRE command performs one of four functions depending upon 
the options selected when entering the command. The possible forms 
of the ENQUIRE command are: 



ENQUIRE Requests the current job status. An important 

feature of this command is that it may be entered 
during job execution. The system responds by 
printing: 

TERMINAL nnn.iii 

SYSTEM - (subsystem currently active) 

FILE NAME: (primary file name) 

STATUS - (IDLE, WAIT, or EXE- 

CUTE) 

where: 



nnn Terminal number 

iii Identifier that describes type of 

terminal 



TTY ASCH code terminal 

COR Correspondence code 

terminal 

CORAPL Correspondence code 

terminal with APL print 

MEMAPL Memorex 1240 (ASCH 

code) terminal with APL 
print 
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ENQUIRE, F 



Requests the current job status, The system 
supplies the information described in the pre- 
ceding format plus the file information supplied 
with the LENGTH command. Note that this com- 
mand cannot be entered when the job is in WAIT 
or EXECUTE status. An example of the EN- 
QUIRE , F eommand follows . 



TERMINAL 14, TTY 
SYSTEM - FORTRAN 
FILE NAME: SECT EST 
STATUS - IDLE 

FILENAM TYPE STAT LENGTH UNIT 



SECTEST 
TAPE2 
SECB 
DATA 



.PT 
.LO 
.LO 
.LO 



0051 
0051 
0051 
0051 



0. 002 KPR. 

0.002 KPR. 

0. 046 KPR. 

0.002 KPR. 



ENQUIRE, T Requests the accumulated system second time 
for this session. For example: 



SS 



0.046 



SECS. 



I 



ENQUIRE, J= Requests the status of a remote batch job that was 
jobname initiated with the SUBMIT command. Remote 

entry jobs can be submitted from either the time- 
sharing terminal or from EXPORT/IMPORT. 
The jobname parameter is the name assigned to 
the job, by the system, when it is submitted. 
The possible replies are: 



JOB NOT FOUND. 

JOB IN INPUT QUEUE. 

JOB IN OUTPUT QUEUE. 

JOB IN PUNCH QUEUE. 

JOB EXECUTING. 

JOB IN TIMED/EVENT ROLLOUT 

The JOB NOT FOUND, message normally indi- 
cates that the job has been processed and no 
longer exists in the system. However, if the 
jobname is entered incorrectly (misspelled), 
this message may also be issued. 

The JOB EXECUTING, message indicates that 
the job is either executing or has been rolled out 
for a higher priority job. 
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It is only possible to obtain the status of jobs 
submitted under the current user number. Refer 
to section 8 for a complete description of remote 
job entry. 

EXECUTE, ccc Selects the EXECUTE subsystem. This subsystem is used only to exe- 

cute a previously compiled (object code) program. The RUN (or RNH) 
command must be entered to initiate execution. The ccc parameter is 
optional and enables the user to specify an additional command. Al- 
though any valid command is permitted (as well as all valid parameters 
for that command), only one additional command may be specified. The 
following example illustrates the use of this option. 

EXECUTE, OLD, OBJFILE 

Di this example, the user selects the EXECUTE subsystem and the OLD 
file OBJFILE in one command. Note that the file name (OBJFILE) is a 
valid parameter with the OLD command. 

If ccc is omitted and no primary file is currently defined, the system 
responds : 

OLD, NEW, OR LIB FILE: 1 " 

The user may then specifvttie file type and the file name (separated by 

a comma) followed by a (CR) . If the file name is omitted in the reply, | 

the system responds: "' 

FILE NAME: 

The user then specifies the file name followed by a (cr) . 

NOTE: Source language programs cannot be executed under the 
EXECUTE subsystem. 

The EXECUTE subsystem should be used whenever possible to improve 
time-sharing efficiency. This can be achieved when certain programs 
are used frequently. For example, a source code program created 
under the FORTRAN subsystem must first be compiled before it can be 
executed. This process is automatic. The user needs only to enter the 
RUN command. 

The program automatically goes through a compilation phase which pro- 
duces an executable object code (binary) program. The object code pro- 
gram is then executed. From this, it can be seen that retaining the 
object code program in the permanent file system for later execution 
under the EXECUTE subsystem provides greater efficiency. This can 
be accomplished through use of the RUN, B=lfn command. This command 
causes the object code program to be placed on a working file (lfn) speci- 
fied by the user. That file is then retained in the permanent file system 
by entering the command SAVE , lfn. 



t 



LIB is an abbreviation of the command LIBRARY. Refer to the description of this command later in 
this section. 
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Note that since the file containing the object code is not the primary file, 
a subsystem flag is not associated with the file when it is saved. In this 
case, the EXECUTE subsystem will not be selected automatically when 
the file is requested using the OLD command. The user must ensure 
that the EXECUTE subsystem has been selected before attempting to 
execute the program. 

To associate the EXECUTE subsystem with the file containing the object 
code program, enter the following commands. 

EXECUTE, NEW, lfn Selects the EXECUTE subsystem and 

specifies a new primary file name (lfn) 

NODROP Prevents the working file containing the 

object code program from being released 

SAVE Retains the primary file in the permanent 

file system and sets the EXECUTE sub- 
system flag. The file contains no infor- 
mation at this point. 

REPLACE, lfn=pfn Copies the contents of the working file 

containing the object code program (lfn) 
to the permanent file created with the 
SAVE command (pfn). This command 
can be entered regardless of the sub- 
system currently being used. It has no 
effect on the EXECUTE subsystem flag . 
associated with file pfn. 

If this is done, subsequent requests to the file using the OLD command 
cause the EXECUTE subsystem to be selected. Entering the RUN com- 
mand initiates execution of the object code program. 

FORTRAN, ccc Selects the FORTRAN subsystem. The ccc parameter is optional and 

enables the user to specify an additional command. Although any valid 
command is permitted (as well as all valid parameters for that com- 
mand), only one additional command may be specified. The following 
example illustrates the use of this option. 

FORTRAN , OLD , DATA GEN 

In this example, the user selects the FORTRAN subsystem and the OLD 
file DATAGEN in one command. Note that the file name (DATAGEN) is 
a valid parameter with the OLD command. 

If ccc is omitted and no primary file is currently defined, the system 
responds : 

OLD, NEW, OR LIB FILE: 1 " 



LIB is an abbreviation of the command LIBRARY. Refer to the description of this command later in 
this section. 
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The user may then specify the file type and file name (separated by a 
comma) followed by a (CK\ . If the file name is omitted in the reply, 
the system responds : ^^ 

FILE NAME: 

The user then specifies the file name followed by a (c 

NULL Clears the subsystem currently in use. The system responds: 

READY. 

This command is entered before saving the primary file if the user does 
not want a specific subsystem flag to be associated with the file. Nor- 
mally, when a user saves the primary file, an internal indicator called 
the subsystem flag is set to indicate the subsystem currently in use. 
That subsystem is automatically selected in each succeeding request 
for the file using the OLD command. Note that there is no subsystem 
association when saving working files other than the primary files. 

If the user does not specify a subsystem at log-in time, the system as- 
sumes NULL by default. 



TIME-SHARING JOB COMMANDS 

The time-sharing job commands allow the user to perform a variety of job processing or job related 
operations. These commands may be entered at any time after the log-in procedure is complete. 

APL.t.www Selects the APL (a programming language) interactive interpreter. This 

command also specifies translation to the full 128-character code set. 
All characters are recognized although input control characters are not 
processed. Rather, they are passed to the program as data. The para- 
meters t and www are both optional and are defined as follows : 

t Specifies one of the following terminal types : 

TTY ASCII code terminal with standard 

print 

MEMAPL Memorex 1240 terminal (ASCII code) 

with APL print 

COR Correspondence code terminal with 

standard print 

CORAPL Correspondence code terminal with 

APL print 

www Specifies the workspace to be loaded. IE this para- 

meter is omitted, APLLIBS is assumed by default. 

Refer to the APL CYBER Reference Manual for complete information 1 

concerning the use of APL. 
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BINARY, ccc 






BYE 



Selects binary input mode. Under control of this command, eight-bit 
characters entered from the terminal are stored, without translation, 
in the primary file. Normally, characters entered from the terminal 
are translated and stored as 6-bit or 12-bit internal display codes (refer 
to Central Memory Character Equivalents in Appendix B for complete 
information). 

ccc Terminator character; a three digit octal code that 

corresponds to a character which the user selects to 
terminate binary input mode. A maximum of 628 
characters may be input prior to a terminator char- 
acter. There are three valid binary mode terminators , 
their octal codes , and terminal keys are as follows : 



Terminator 

Carriage return (CR) 
End-of-text (ETX) 
End-of-transmission (EOT) 



ASCII Code Terminal Key 

215 Carriage return 

003 CONTROL 

204 CONTROL 



Four characters (all odd parity) cannot be sent on network ports, 
following illustrates the values : 



The 





Odd Parity 


Line 


Display Code 


ASCII Character 


Code in Octal 


(Octal) 


ESC 


233 




7677 


US 


037 




7675 


GS 


235 




7654 


ETB 


227 




7642 



Logs the user off the system and disconnects the terminal. The system 
responds by printing: 



usernum LOG OFF. 
usernum SS 



hh.mm. ss. 
s.sss SEC. 



where: 

usernum User number 

hh.mm. ss. Time of day this command was entered 

s. sss Total system second time used since log-in 

NOTE: The user should make certain that all working files to be retained 
are made permanent before issuing this command. All working files not 
saved are released when the BYE command is processed. 



CHARGE, chargeno, 
projectno 



This command allows the user to specify a valid charge number and pro- 
ject number to be billed for subsequent terminal operations. Although 
certain users are required to enter a charge and project number during 
the log-in sequence, all users may issue the CHARGE command as long 
as the charge and project numbers entered are valid. This command 
can be entered at any time during the time-sharing session. Both charge 
number (chargeno) and project number (projectno) parameters are re- 
quired. The system responds: 



READY. 
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CLEAR 



Releases all working files. Only the primary file name is retained 
(contents of the primary file are released). The system responds: 

READY. 

All files to be retained must be made permanent before entering this 
command. 



{ 



DAYFILE 



line of output returned to the terminal is in the form 



hh.mm.ss. 



message 



where: 

hh. mm. ss. Time of day the message was placed in the day- 

file 

An alternate form for this command is: 



EDIT, lfn 



GOODBYE 

HELLO 



HELP 



DAYFILE, lfn 

In this instance, the dayfile is written onto a local file (lfn) instead of 
simply being printed at the user's terminal. 

Selects the KRONOS Text Editor. The lfn parameter specifies the name 
of an existing working file to be edited. The lfn parameter may also 
specify a new working file name. In this case, the new file is con- 
structed using the Text Editor. If the lfn parameter is omitted, the 
primary file name is assumed. When necessary, the primary file is 
sorted prior to the initiation of text editing. 

All working files consisting of several logical records should be com- 
pressed into one logical record before entering this command (refer to 
PACK command described in this section). If this is not done, the con- 
tents of all but the first logical record is lost. For additional informa- 
tion, refer to the Text Editor (EDIT) Reference Manual. 

Same as BYE command. 

Logs the current user off the system, as in the BYE command, and re- 
initializes the log-in sequence. Any working files that are to be retained 
must be made permanent before the HELLO command is entered. This 
command allows a new user to log-in without first having to establish 
communications with the KRONOS system by dialing the computer site. 

Allows the time-sharing user to obtain assistance in the use of KRONOS 
commands. If the user at a terminal is not sure of the format of a com- 
mand or its use, the HELP command provides an easily accessible on- 
line description of the KRONOS command set. The system responds by 
printing: 



< 
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IF MORE INFORMATION NEEDED, 
TYPE THE COMMAND NEEDED. 

9 



TYPE YES. OTHERWISE, 



Interrupt (BREAK 
or ATTN key) 



INFO 



LENGTH, lfn 



The user then types YES in reply to the request or else enters the com- 
mand he wishes to have described. A minimum of three characters must 
be entered if a command is typed. The user must type END after a 
question mark (?) to terminate the HELP command. 

Interrupts a program that is currently transmitting output to the terminal. 
The system responds : 

♦INTERRUPTED* 

The user must press the carriage return key or type P followed by a 
carriage return to continue. However, if the TAPE command is in 
effect (tape mode), a carriage return cannot be entered as the first 
character of a new line. In this case, P followed by a carriage return 
must be entered to continue. Refer to job suspension in section 7 for 
additional information. If the user wishes to terminate the interrupted 
operation, enter the next command or line number, or enter the STOP 
command. 

The BREAK key is used for interrupt on ASCH code terminals and the 
ATTN key on correspondence code terminals. For complete informa- 
tion concerning the use of special function keys on both ASCII and cor- 
respondence terminals, refer to Table B-l in Appendix B of this manual. 

If an interrupt should accidentally disconnect the terminal from the 
system, the user can log-in again and enter the RECOVER command 
in response to the RECOVER/SYSTEM: or RECOVER/CHARGE: re- 
quest. The user then continues processing from the point at which the 
loss of communication occurred. For more information on recovery 
procedures, see section 7. 

Produces a listing of current general information about the CYBERNET 
Center that the user is now accessing. The user initially receives in- 
structions on how to acquire this information on a series of topics. 
Then, he selects which topics interest him. Typical topics include a 
list of current KRONOS subsystems and planned changes, a list of recent 
changes to the overall operating system, information about various com- 
pilers (e.g. , TSRUN, RUN23), and information about the Center's weekly 
operating hours. 

Prints the file name, file type, last status, and length of the working file 
specified by lfn. If the lfn parameter is omitted, the primary file is as- 
sumed. In this case, the primary file is sorted before the length is ob- 
tained, unless a NOSORT command precedes the LENGTH command 
{refer ta description, of, NOSQRT commmdin this section). 
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The system responds: 



FILENAM 


TYPE 


STAT 


LENGTH 


UNIT 


lfn 


.tt 


xxxx 


y.yyy 


KPR. 



where: 



lfn 

.tt 



xxxx 



y.yyy 



Local (working) file name 

File type 

. PM Direct access permanent file 

. PT Primary working file 

. LO Any working file that is not the current 

primary file or a direct access permanent 

file 

The three following file types appear only if the user 
is in the BATCH subsystem. 



„CM 


Common file 


.LI 


Library file 


.SY 


System file 



An * preceding the file type indicates a locked file 
(user cannot write onto a locked file). 

Working file status. Refer to KRONOS Reference 
Manual for description of status codes. 

Length of file in kilo physical record (KPR) units. 
A KPR is equal to 1000 physical record units (PRUs). 
A PRU contains 640 six-bit characters. 



< 



Example: 



LENGTH, DERFILE (C 
FILENAME TYPE 
DIRFILE *PM 



* (user enters command) 

STAT LENGTH UNIT 
0051 0.019 KPR. 



LIBRARY 



Allows a user to access a file that was previously saved in the permanent 
file system under special user number LIBRARY. The system responds: 



FILE NAME: 

The user then enters the selected file name, 
system replies: 

READY. 



When the file is found, the 



The file selected becomes the new primary file and all current working 
files (if any) are released unless the NODROP command immediately 
follows this command sequence. Special considerations in the use of 
this command are described at the end of section 5. 



! 
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LIBRARY, lfn= 
pfn/options 



LIMITS 



LIST, xxx, R, 
F=lfn 



( 



This is an optional form of the preceding command. It allows the user to 
specify the command LIBRARY, the selected file name, and special 
options on the same line. Refer to the command description in section 5 
for information concerning this command format. Special considerations 
in the use of this command are described separately at the end of section 
5. 

Provides a listing of the user's current validation limits. Refer to 
Limits Command at the end of this section for a complete description 
of this command and a sample listing. 

Prints the contents of the primary file at the terminal unless the F option 
is specified. The primary file is automatically sorted before listing 
unless a NOSORT command precedes this command (refer to description 
of NOSORT command in this section). 



xxx 



R 



F=lfn 



Line number of the line where listing is to begin. 
This parameter is optional and may be specified 
only if the primary file is being listed. 

End-of-record and end-of-file marks are to be indi- 
cated in the listing if present (optional). This lists 
the primary file from the beginning to the end-of- 
information unless the xxx parameter is specified. 

Lists working file lfn (optional). The file is not 
sorted before listing. When this parameter is 
specified, neither the xxx nor the R options can be 
supplied. The working file specified is listed from 
the current position to the end-of -information. 



The system replies: 

yy/mm/dd. hh.mm.ss. 
PROGRAM nnnnnnn 



header 



LNH,xxx,R, 
F=lfn 



(program lines) 

READY. 

The header information printed is: 

yy/mm/dd. Current date 

hh.mm.ss. Current time 

nnnnnnn File name 

This is an optional form of the preceding command which lists the file 
without a header. 
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LOGIN 

NEW 



NEW.lfn 



NODROP 



NOSORT 



OLD 



Same as HELLO command. 

Allows the user to create a new primary file. The system responds: 

FILE NAME: 

The user enters a valid file name. When the system accepts the new file 
name, it replies: 

READY. 

The file name specified becomes the new primary file and all current 
working files are released unless NODROP is the next command entered. 

This is an optional form of the preceding command which allows the 
user to specify NEW and the file name in one step. 

Prevents the system from releasing current working files when the 
user issues the OLD, NEW, or LIB command to obtain a new primary 
file. This command must be entered immediately after the OLD, NEW, 
or LIB command sequence is complete. The system responds: 

READY. 

Refer to Working File Control in section 3 for an example of this 
command. 

Prevents the system from automatically sorting the primary file. This 
is done by clearing an internal indicator called the sort flag. Sorting 
of the primary file is initiated only if the sort flag is set when the LIST, 
RUN, EDIT, LENGTH, or SUBMIT command is entered. The system 
responds : 

READY. 

This command is generally used when making additions and/or modifi- 
cations to the primary file. When followed by the NOSORT command, 
the additions and/or modifications create a new logical record in the 
primary file. Note that the NOSORT command remains in effect only 
until the next numbered line of source code is entered. This causes the 
sort flag to be turned on again. Refer to the description of file sorting 
in section 3 for an example which illustrates the effect of the NOSORT 
command. 

Allows the user to access a file that was previously saved in the per- 
manent file system. The system responds : 

FILE NAME: 

The user then enters the selected file name. When the file is found, 
the system replies: 

READY. 



f 



i 
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The selected file becomes the new primary file. If a specific subsystem 
is associated with the file, it is selected automatically. This occurs only 
if the file was originally the primary file and was saved while a subsys- 
tem other than NULL was active. All working files are released fol- 
lowing entry of this command unless the next command entered is 
NODROP. 



OLD,lfn=±pfn/ 
options 



PACK.lfnp 
lfn 2 ,NR 



This is a special form of the preceding command. It allows the user to 
specify the command OLD, the file name, and special options on the 

OdlllC J.11XV • IVVlVi t*\J ULLV* VV/11UJ-LCMI\A VlUk) VJLAL/VJ.VU J.J.J. t3 ^ VV1UU V J-V^ X. JJUJ. V i XJ.±» 



tion concerning this command format. 

Compresses (that is, packs) a file consisting of several logical records 
into one logical record. When the operation is complete, the system 
responds : 



READY. 



PASSWOR, oldpswd, 
newpswd 



The PACK command may be entered in one of the four following formats 
depending upon the options selected. 

PACK Packs the primary file into one logical record. 

When the primary file is packed, it is not sorted 
automatically by subsequent operations that nor- 
mally cause the file to be sorted (that is, LIST, 
RUN, etc.). Automatic sorting resumes when the 
user enters the next line of source code or the 
SORT command. 

PACK, lfn Rewinds and packs working file lfn into one logical 
record. File lfn is rewound again after the pack. 

PACK, lfo^ , Rewinds and packs working file lfn^ into one logical 
lfn, record and then writes the file to lft^. ^ ^2 eur ~ 

rently exists , lfn^ is written at the current position 
of lfi^. File lfn 2 is rewound after the pack; lfn^ 
is not. 

PACK,lfn^, Same as the preceding format, except that the no 
lfn 2 , NR rewind (NR) parameter inhibits file lfnj from being 

rewound before the pack, unless it is the primary 
file. The primary file is rewound after all oper- 
ations . 

Allows validated users to change their password. The user must supply 
the correct current password (oldpswd) and a four-to-seven-character, 
alphanumeric, new password (newpswd). 

If any part of this command is in error, the system replies: 

ERROR m PASSWORD ARGUMENTS. 
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RECOVER 



RENAME, lfn 1 =lfn 2 



RESEQ 



RETURN, Ifn 
REWIND, If n 

RUN 



After the password has been changed, the system replies: 

READY. 
If the user is not validated to use this command, the system responds: 

ILLEGAL CONTROL CARD. 

Tf ttlft IlfiW n»KKWr»rr5 is lf«S than fnilf r>Viar»jrW-ar.C! ^nrlcT r\r- io tAamHrtnl 

to the user number, the system will respond with the following error 
message: 

ILLEGAL NEW PASSWORD. 

Enables the time-sharing terminal user to resume processing after 
having been accidentally disconnected from the system or when a system 
malfunction requires that the log-in sequence be reinitiated. Refer to 
Recovery in section 7 for a complete description and examples of the 
use of this command. 

Changes the name of working file lfn 2 to file name Ifnj. If file l&n cur- 
rently exists , it is released. This command cannot be used to change 
the name of a permanent file. However, a working file can be renamed 
and then saved in the permanent file system under the new name. 

This command enables the user to resequence the line numbers of the 
primary file. If the current primary file is a text file, line numbers 
can be added. Statements that reference line numbers are updated when 
BASIC programs are resequenced. Refer to Resequencing Line Numbers 
in section 7 for a complete description and examples of the use of this 
command. 

Releases working file lfn. 

Positions working file lfn at the beginning-of -information (BOI). Refer 
to File Structure in section 3 for additional information. 

Compiles and/or initiates execution of the primary file or another 
working file. The primary file is sorted before being compiled unless 
a NOSORT command precedes this command (refer to description of 
NOSORT command in this section). The system responds: 



< 



yy/mm/dd. hh. mm. ss . 



PROGRAM 



nnnnnnn 



header 



(data or error messages) 

SS s.sssSECS. 

RUN COMPLETE. 
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One or more of the following options may be supplied with the RUN com- 
mand. 



RUN,B=lfn 

or 
RUN, C=lfn 



RUN,I=lfn 



Compiles the source program and generates 
a binary file containing the resultant object 
code on file lfn. The source program is not 
executed. File lfn can later be executed under 
the EXECUTE subsystem by entering the RUN 
command. File lfn can be retained as a per- 
manent file using the SAVE (or REPLACE 
command). 

Compiles and/or executes working file lfn 
( lfn is assumed to be sorted). In the EXE- 
CUTE subsystem, no compilation occurs. 



RUN, MA=nnnnn Uses nnnnn as the octal field length for the 
current job.' 

RUN,MI=nnnnn Increments the job's current field length by 
nnnnn octal. Refer to Example 1. * 



RUN.T.q-pqa, 



»q. 






This command applies only when running a 
previously compiled (object code) FORTRAN 
program in the EXECUTE subsystem. It 
allows the user to rename working files speci- 
fied in the PROGRAM statement without re- 
compiling the program. The parameters q^ 
through q n are used to specify new working 
file names to be used in place of those that 
currently exist in the PROGRAM statement 
(the parameters are order-dependent and 
must correspond to those they replace). 
Refer to Example 2. 



.*£ the user exceeds the maximum field length for which he is validated, the message ILLEGAL USER 
ACCESS is returned to the terminal. 



4-21 



Example 1: 

The following example illustrates the use of the RUN, MI=nnnnn command. 

LNH 

00100 PROGRAM M (INPUT, OUTPUT)/Causes program to exceed field 
00110 DIMENSION J(17000) ■*—. ^ length (included solely for pur- 

nni9fl DPUFT 4 -r^c,!, nt Jll, ,„+„„<-,•„„ \ 

00130 4 FORMAT (*ENTER TWO NUMBERS*) 

00140 READ, A, B 

00150 C=A*B 

00160 PRINT 5 

00170 5 FORMAT (*A X B*) 

00180 PRINT, C 

00190 END 

READY. 

RUN 



73/03/01. 
PROGRAM 



16.07.31. 

M 



AT LINE NUMBER 00190 MORE STORAGE NEEDED FOR COMPILATION 
000001 FORTRAN ERRORS IN M 



SS 0.164 SECS. 
RUN COMPLETE. 
RUN,MI=3000 «— 



73/03/01. 16.08.41. 
PROGRAM M 

ENTER TWO NUMBERS 

? 16,23 

AXB 

368.00 

END. 

SS 0.396 SECS. 
RUN COMPLETE. 
Example 2: 



Diagnostic indicates that job's 
current field length was in- 
sufficient. 



■ Additional field length is re- 
quested. 



The following example illustrates the use of the RUN, T command. As- 
sume a FORTRAN program contains the following PROGRAM statement. 

PROGRAM TEST (INPUT, OUTPUT, AAA,BBB,TAPE1=AAA,TAPE2=BBB) 



i 
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Norma.u.y, to execute a program containing this statement, the user 
would have to define working file AAA. Working file BBB would result 
from the execution of the program. However, the user could change the 
names of working files AAA and BBB without recompiling the program 
(if the object program exists) by using the RUN, T command under the 
EXECUTE subsystem. For example: 

RUN, T, INPUT, OUTPUT, CCC.DDD 



RNH 



This is an optional form of the RUN command which allows the user to 
run the job without a header being printed. The commands are identical 
in all other respects. 



SETTL.nnnnn 



Sets time limit. This command allows the user to specify a time limit 
(nnnnn octal seconds) for all subsequent operations requiring the central 
processor. If nnnnn is omitted, the system assumes nnnnn=100B seconds 
which is the normal default value at log-in time. The minimum time 
limit that can be entered is 10B seconds. The maximum time limit 
is dependent upon the user's validation limits (refer to Limits Command 
at the end of this section). 



< 



SORT 



This command is useful when debugging a program that is cycling in a 
loop. It prevents the user from accumulating a large bill for computer 
usage. 

Sets an internal indicator called the sort flag. Sorting of the primary 
file takes place when the next LIST, LENGTH, EDIT, SUBMIT, or RUN 
command is entered. The lines of the primary file are then arranged 
in order according to the first five digits of the line number, and the 
file is packed into one logical record. 



SORT.lfn, 

NC=n 



Sorts working file lfn by arranging the statements in order according to 
the first n digits of the line number (where 1 <n S10). If the NC option 
is omitted, the sort is performed using the first five digits of the line 
number. File lfn is also packed into one logical record when the sort is 
performed. When the sort is complete, file lfn is positioned at end-of- 
information (EOI) unless it is the primary file which is automatically 
rewound. This command forces immediate sorting of the specified file 
and is commonly used to sort the primary file when it is too long to be 
sorted automatically by the system. Refer to description of File Sorting 
in section 3 for additional information. 



STATUS options 



See the ENQUIRE command for a complete description, 
used in place of ENQUIRE. 



STATUS may be 



STOP 



Terminates any program that is currently in execution or waiting for 
input from the terminal. The system responds: 



TERMINATED. * 
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SUBMIT Allows a validated user to create a batch job deck image and submit it 

to the local batch queue as a deferred batch job. The user cannot inter- 
act with a job submitted for processing using this command. Rather, the 
job is treated in the same manner as a job submitted from the card 
reader at the local computer site or from EXPORT /IMPORT. This pro- 
cess is commonly referred to as remote job entry. Refer to section 8 
for a complete description and examples of the use of this command. 
It is recommended that the user become familiar with all information in 

TEXT Enter text mode. This command allows keyboard entry of source code 

(program statements, data, or text) into the primary file without speci- 
fying line numbers . Commands entered in text mode are interpreted as 
text and are not processed by the system. The system responds: 

ENTER TEXT MODE. 

To terminate text mode from an ASCII code terminal, press the inter- 
rupt key (generally labeled INT, INTRPT, or BREAK). If a correspon- 
dence code terminal is being used, press the ATTN key. Note that in 
either case, the carriage must be positioned at the beginning of a new 
line (empty input line) to be effective. The system responds : 

EXIT TEXT MODE. 

Since a text file does not normally contain line numbers, and therefore, 
cannot be sorted (and packed) automatically by the system, a PACK com- 
mand should be issued after exit from text mode to ensure that the data 
is in one logical record. 

-lfn Initiates processing of procedure file lfn. This allows the user to pro- 

cess a procedure file and remain interactive with his job. 

A procedure file is a source file which contains control card images 
and/or KRONOS control language (KCL) statements. It has the same 
structure as the control card record in a normal batch job although the 
JOB and ACCOUNT control cards required in batch jobs cannot be in- 
cluded. 

Optional parameters may also be included in this command. The com- 
mand format with options is: 

-lfn,S=ccc(oldnam,=newnam, , oldnam =newnam„ , . . . ,oldnam =newnam ) 
v 1 12 2 n n' 

where: 

lfn Name of the procedure file to beprocessed. 

KRONOS searches for lfn according to the 
following hierarchy. 

1. Check current working files (including 
primary file) . 



I 
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2. Check user's permanent file catalog for 
indirect access permanent file. File must 
not have an associated password. 

3. Check system-defined procedure files . This 
can be a procedure file created by the instal- 
lation and included as part of the KRONOS 
system. 

4. Check user number LIBRARY. 

If the specified file cannot be found, the system 
responds : 

lfn NOT FOUND. 

S=ccc Specifies control statement ccc as the first 

statement in the procedure file to be executed. 

oldnani=newnam For each occurrence of oldnam in the proce- 
dure file, substitute newnam. This allows use 
of the same procedure file to perform several 
tasks depending upon the parameters specified. 

To create a procedure file from the terminal, the user should enter text 
mode (refer to TEXT command). After leaving text mode, issue the 
PACK command to ensure that the file is packed into one logical record. 
The file can then be SAVEd for future reference as an indirect access 
permanent file. If changes have to be made to the procedure file, it is 
necessary to use the KRONOS Text Editor (refer to EDIT command). 

Refer to the KRONOS Reference Manual for information concerning the 
KRONOS control cards and KCL statements available. 



LIMITS COMMAND 

Entry of the LIMITS command provides a listing of the user's validation limits. Generally, validation 
limits are the internal system controls associated with each user number which govern his use of cer- 
tain system resources. The listing provided describes both the resources available to the user and the 
extent to which they may be used. All numeric values listed are decimal unless the post radix B appears 
signifying an octal value. The following information is listed. 

Field Description 

MT t Maximum number of magnetic tapes the user is allowed to have assigned 

to his job concurrently. 
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Field Description 

RP Maximum number of auxiliary devices the user is allowed to have as- 

signed to his job concurrently. 



TL 



FC 



■ttt 



Maximum amount of system second time allowed for the user's job 
(refer to SETTL command). 



PRI Maximum central processor priority allowed for the user's job. 

CM Maximum number of central memory words that the user is allowed to 

request. This is the job's maximum field length. CM is in hundreds 
of words (octal) . 

NFtt Maximum number of files that the user is allowed to have associated 

with his job concurrently. 

MS Maximum number of mass storage tracks the user is allowed to use. 

DB * Maximum number of deferred batch jobs that the user can have in the 

system concurrently (refer to description of SUBMIT command in 
section 8). 



Maximum number of indirect access permanent files the user can create. 
The number listed represents an upper limit (octal) as follows: 



1=100 5=1000 

2=250 6=2500 

3=500 7=unlimited 

4=750 



CsW Maximum number of PRUs available to the user for indirect access per- 

manent files. The number listed represents an upper limit (octal) as 
follows : 



1=1000 5=50000 

2=2000 6=100000 

3=5000 7=unlimited 
4=10000 



* For further information about this field, refer to the KRONOS Reference Manual. 

Not currently used by the system but provided for future expansion. 
ttt 

If the value listed for this field is SYSTEM, the actual value used is a system option. Refer to the 
KRONOS Reference Manual for additional information. 
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Field Description 

FS^ Maximum number of PRUs available to the user for any given indirect 

access permanent file. The number listed represents an upper limit 
(octal) as follows: 



1=10 


5=500 


2=50 


6=1000 


3=100 


7=unlimited 


4=200 





PA Specifies that ODD or EVEN parity is associated with the terminal (refer 

to PARITY command under Terminal Control Commands in this section). 

RC-t Number of rubout characters required for carriage return delay (refer 

to ROUT command under Terminal Control Commands in this section). 

PX Specifies full- or half-duplex transmission mode is associated with 

terminal (refer to FULL and HALF commands under Terminal Control 
Commands in this section) . 

TT Specifies type of terminal; value listed may be: 

TTY ASCII code terminal with standard print 

i MEMAPL Memorex 1240 terminal (ASCII code with APL print) 

COR Correspondence code terminal with standard print 

CORAPL Correspondence code terminal with APL print 

Refer to TERM command under Terminal Control Commands in this 
section. 

AW Access word; the octal value listed corresponds to the following access 

options (bit is option 1, bit 1 is option 2, etc. ). 

Option Signifies 

1 User can change his password (refer to PASSWOR 

command) . 

3 User is allowed to create direct access permanent 
files. 

4 User is allowed to create indirect access permanent 
files. 

7 User can assign nonallocatable devices (refer to 

KRONOS Reference Manual) . 



*. .— 

If the value listed for this field is SYSTEM, the actual value used is a system option. Refer to the 

KRONOS Reference Manual for additional information. 
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Option Signifies 

8 User is allowed to access system without supplying 
his assigned charge and project numbers. 

9 User can create and/or replace files on auxiliary 
devices . 

11 User is designated as a "no timeout" terminal. If 

this bit is not set, the terminal will automatically 
log off after 10 minutes of inactivity. With this bit 
set, the terminal remains connected until the user 
logs off. The TIMEOUT command (section 4) 
clears this bit. 

For example, if the access word listed were 

AW=00000000000000000115 

the user would be validated for options 1, 3, 4, and 8. 

If any parameters are included with the LIMITS command, the system responds: 

ERROR IN LIMITS ARGUMENTS. 

The following is an example output listing produced by LIMITS. 

LIMITS. 75/08/01. 15.57.35. PAGE 1 

USER123 74/09/03. 75/07/18. 



I 



LAST PASSWORD CHANGE WAS 18 DAYS AGO. 



t 



MT = 




4 




RP = 









TL = 




7777B 




PR = 




30B 




CM = 




1200B 




NF = 




20 




MS = 




100 




DB = 




20 




FC = 




SYSTEM 




CS = 




SYSTEM 




FS = 




SYSTEM 




PA = 


EVEN 






R0 = 









PX = 


HALF 






TT = 


TTY 






TC = 


STANDARD 




IS = 


NULL 






AW = 


00000000000000000115 


READY. 









t The password message will state the number of days since the password was last changed up to 
a maximum of 60 days. If a password has not been changed within a 60 day period, the message 
will read: LAST PASSWORD CHANGE WAS OVER 60 DAYS AGO. 
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All time-sharing users may access permanent files after the log-in procedure is com- 
plete. Validated users may also create permanent files (refer to LIMITS Command at 
the end of section 4 for information concerning user validation limits). 

The user number supplied during log-in represents a specific catalog in the permanent 
file system. The catalog contains a list of files saved under that user number as 
well as pertinent information about each file. All permanent file requests are made 
to this catalog unless an alternate user number or an auxiliary device is specified in 
the file request, f If an alternate user number is specified, the request is made to 
that user's catalog. If a validated user specifies that the file resides on an auxiliary 
device, the request is made to a separate catalog on that device. A separate catalog 
exists on the auxiliary device for each user with files on that device. 

User numbers that contain asterisks (*) represent users with automatic read-only per- 
mission to files in catalogs of other users. The user number must match the alter- 
nate user number in all characters that are not asterisks. For example, a user with 
the user number *AB*DE* can access all files in the catalogs of the following users. 

UABCDEF 
UABDDEE 
V MABCDE1 

MAB1DE3 

All permanent files are classified according to the manner in which they are accessed. 
There are indirect access and direct access permanent files. The mode of access is 
determined by the command used to create the file. Indirect access permanent files 
are created with the SAVE command while the DEFINE command must be used to 
create a direct access permanent file. The command used to create a permanent file 
also determines the command that must be used to access the file. The user must 
enter the OLD, LIBRARY, or GET command in requests for indirect access files. 
The ATTACH command must be entered to request use of a direct access file. The 
following are characteristics of each type of file. 

• Indirect access 

An indirect access file is, as the name implies, a permanent file that cannot be 
accessed directly by the user. Instead, when access is requested through entry 
of the OLD, LIBRARY, or GET command, a copy of the permanent file is created. 
The copy, considered a working file, is referenced instead of the permanent file 
in all subsequent I/O operations. This feature offers protection from en- 
dangering the integrity of the permanent file. Several copies of an indirect 
access file may exist in the system at the same time. Note that if the work- 
ing file is altered, the user must enter the REPLACE command in order to 
update the permanent file. If the user is not allowed to update the permanent 
file, he can create a new indirect access file (to reflect his modifications) by 
entering- the SAVE command and specifying a new file name. 

tAn auxiliary device is a mass storage permanent file device used to supplement the 
normal permanent file devices associated with the system (family devices). 
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Indirect access permanent files are allocated in blocks of 64 central memory 
words (one physical record unit). Wien compared to the size of blocks allo- 
cated for direct access files (refer to appendix D), this block size is relatively 
small. Jims, permanent files that are small in size are typically indirect 
access files. This is done to avoid allocation of more mass storage area than 
is actually required for the file. 

• Direct access 

A direct access file is a permanent file which, upon request, becomes linked 
^ireet^y to the user's job. Unlike requests for indirect access files, a copy 
of the permanent file is not created for user access. Use of a direct access 
file is requested by entering the ATTACH command, and all subsequent I/O 
operations are performed on the permanent file itself. Note that although a 
copy of the permanent file is not created, a working file name may be speci- 
fied in the request for a direct access file. This allows the user to reference 
the file by a name other than its permanent file name. Because data is 
written directly on the permanent file rather than on a working copy, care 
must be taken when modifying a direct access file. 

Direct access files have a write interlock feature. This means that if one 
user has attached the file in write mode, it cannot be attached by another 
user. Likewise, if a user wishes to attach the file in write mode, he must 
wait until all users currently accessing the file in alternate modes have re- 
leased it. 

Direct access permanent files are allocated in large blocks, and are 
generally used as large data base files. When a user creates a direct 
access file, it is placed on the device with the most space avail- m 

able. By using the space parameter, S, the user may request a specific * 
amount of space at the time a new direct access file is created. 

In summary, the file access mode depends upon the command that was used to create 
the file. Direct access files are created with the DEFINE command. Indirect access 
files are created with the SAVE command. A permanent file cannot be requested as a 
direct access- file one time using the ATTACH command, and as an indirect access 
file later using the OLD, LIBRARY, or GET command. The command that must be 
used to access the file depends upon the command that was originally used to create 
the permanent file. 

PERMANENT FILE COMMAND FORMAT 

The following describes the general format of a permanent file request. If special 
options are desired, they must follow the specified file name. The options must follow 
the / symbol, are order-independent, and are indicated by the specified keyword (kw). 

pfcmdJfn=pfn/kw 1 =option 1 , . . . , kw =option 

pfcmd Permanent file command name 

lf n Working file name used while accessing permanent file pfn. 

Allows user to reference a permanent file by a name other 
than its permanent file name. 

Pfn Name under which the file is cataloged in the permanent file 

directory. If the pfn parameter is omitted, lfn is assumed to be 
the permanent file name. 
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The following are the keywords and corresponding option parameters which may be included. 



Keyword 

UN= 



Option 

usernum 



PW= 



CT = 



passwrd 



( 



M= 



P or PRIVATE 



S or SPRIV 



PU or PUBLIC T 



m 



W or WRITE 



M or MODIFY 



A or APPEND 



R or READ 



Description 

Alternate user number. This parameter is neces- 
sary only if the permanent file involved resides in 
another user's catalog. To access a file in 
another user's catalog, the requesting user must 
be granted explicit permission (refer to PERMIT 
command), must have automatic read-only per- 
mission (user number contains asterisks for all 
characters that do not match in the alternate 
user number), or the file must be a semiprivate 
or public file. 

The user has the option of specifying a one-to- 
seven character password for a file. This pass- 
word must be specified whenever alternate users 
access the file. 

Permanent file category. The file category de- 
termines which users may access a file. There 
are three categories of permanent files. 

Files available for access only by the origina- 
ting user or by those explicitly granted permis- 
sion (refer to PERMIT command). 

Files available for access by all users knowing 
the file name, password, and user number. 
Accesses by alternate users for files of this 
category are recorded for the originator of the 
file. This includes the user number of the al- 
ternate user, the number of accesses made, 
and the date and time of the last access (refer 
to CATLIST command). 

Files available for access by all users knowing 
the file name, password, and user number. 
Only the total number of accesses to files of 
this category are recorded for the originator of 
the file. 

File or user permission mode 

Allows the user to write, modify, append, read, 
execute, or purge the file (modify permission 
applies only to direct access files) 

Allows user to modify information within a 
direct access file and/or append information at 
the end of the file. The user may also read or 
execute the file. This mode applies only to 
direct access files. 

Allows user to append information at the end 
(EOI) of the file 

Allows user to read and /or execute the file 



t The parameter name L or LIBRARY which existed in previous versions of KRONOS 
remains valid for upward compatibility. The parameter name was changed to PU or 
PUBLIC to avoid confusion with the permanent file command LIBRARY. 
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Keyword Option Description 

RM or READMD Allows the user to read a direct access file with the implication 
that another user may currently be accessing the file in MODIFY 
mode. The file may also be executed in this mode. This mode 
applies only to direct access files. 

RA or READAP Allows user to read a direct access file with the implication that 

another user may currently be accessing the file*in APPEND mode. 

The file maV also hfi eXfiClltfid in thlQ mnrtp Thio mrxria onnltoo 

only to direct access files. 

E or EXECUTE Allows the user to execute the file. 

N or NULL None; removes previously granted permission. 

s= space Specifies the amount of space (in decimal PRUs) desired when 

creating a new direct access permanent file (refer to DEFINE 
command). There are 640 decimal 6-bit characters in a PRU. 
KRONOS then creates the file on a device with the specified amount 
of space available. Unused space is not guaranteed to be available 
if the user attempts to expand the file at a later date. If no device 
currently has the specified amount of space available, the system 
responds 

REQUESTED SPACE UNAVAILABLE. 

NA The NA keyword specifies that if a requested resource is not 

available, the command will not be terminated and KRONOS will 
automatically suspend the user's job until the resource becomes 
available. NA can be specified on the ATTACH command to indi- 
cate that the user wishes to wait for the direct access file to be- 
come available. If the file is currently being accessed in a mode 
that conflicts with that specified in the command (interlocked), the 
user's job is suspended and subsequent terminal entry is not 
accepted. To terminate the request, enter the STOP command. 



PERMANENT FILE PROCESSING COMMANDS 

The following list of permanent file commands is available to the user. The parameters specified have 
been described on the preceding pages. 

APPEND, pfn, lfn 2 , . . . , lfn^/ Appends working files lfiij , . . . lfn n at the end of the specified 
UN=usernum, PW=passwrd indirect access permanent file pfn. The logical structure of the 

' """ " v files is retained, that is, EORs and EOFs are appended as well 

as data. Each working file is appended in the order specified in 
the command. This command can only be used for indirect access 
permanent files . 



( 
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ATTACH, lfn=pfn/UN=usernum, Establishes a link to permanent file pfn for direct access usage. 
PW^>asswrd,M=m,NA If pfn is omitted, the system assumes lfn=pfn. 

Note that a working file is not created since user access is made 
directly to the permanent file. Thus, the lfn parameter is used 
when it is desirable to reference the attached file by a name other 
than its permanent file name (pfn). If lfn specifies the name of a 
current working file, the contents of that file is lost when the 
permanent file is attached. In addition, lfn cannot specify the 
primary file name. A direct access file cannot become the pri- 
mary file. 

If the M keyword (permission mode) is omitted, the system 
assumes read permission for the attached file. The m keyword 
must be specified by all users, including the originator, if the 
file is to be modified or new information is to be added to the file. 

If the NA keyword is not specified and another user is currently 
accessing the file in a mode that conflicts with that specified in 
the command (M keyword), the system responds 

lfn BUSY. 

NOTE: Although the system response gives the logical file name, 
lfn, it is actually referring to the permanent file, pfn, which is 
the busy file. 

If a direct access permanent file has been attached in the WHITE 
mode, it should be released after use in order to be attached by 
other users, f In general, it is best to access the file in a mode 
that allows other users to access the file at the same time. 

A direct access permanent file can be released with any of the 
following commands (refer to section 4 for a description of these 
commands). 

• OLD, NEW, or LIBRARY (all working files also released) 

• GOODBYE, BYE, HELLO, or LOGIN (all working files 
also released) 

• CLEAR (all working files also released) 

• RETURN, lfn (file specified is released) 

A direct access file will also be released if the lfn parameter on 
subsequent GET or ATTACH commands specifies the name of 
the attached file. 



^When a direct access permanent file is attached in the WRITE mode, the last modification date is 
incremented even if the file is not altered. 
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CHANGE, nfn=ofn/ 
PW^passwrd, CT=n, 

M=m 



Allows the originator of a direct or indirect access permanent 
file to alter any of several parameters without having to attach 
and redefine the file or retrieve and save it. Note that this com- 
mand is valid only for the originator of the file (UN keyword is 
illegal). 



I 



The nfn parameter specifies the new permanent file name to be 
assigned; ofn is the current file name. If no name change is de- 
sired, only ofn is specified. The CT, M, and PW keywords 

^>iivM..m u\, op^v»icu umj 1.1 a. ^ucuigc in nic veiiuc a»c»ut;icii't;u Willi 

that keyword is desired. 

If the specified permanent file, ofn, is not in the user's catalog, 
the system responds 

ofn NOT FOUND. 

If a new permanent file name, specified by nfn, already exists in 
the user's catalog, the system responds 

nfn ALEEADY PERMANENT. 

The CHANGE command also updates the last modification date 
and last access date for the file. 



DE FINE, lfn=pfn/PW= 
passwrd, CT=^i, M=n, 
S=space 



Allows a validated user to create a direct access permanent file 
(pfn) and attach it in WRITE mode. If pfn is omitted, the system 
assumes lfn=pfn. 



If pfn is specified, the lfn parameter can be used as follows: 

To reference the direct access file by a name other than its 
permanent file name (pfn). hi this case, the direct access 
file created contains no information initially. Data is 
placed on the file in succeeding write operations. 

If the optional keywords are omitted, the system assumes the 
following values. 



PW 


None 


CT 


PRIVATE 


M 


WRITE 



S File is placed on device 
with most space available 



If the user releases the file and then wishes to access it at some 
time in me future, the ATTACH command must be entered (refer 
to the ATTACH command). 

For information regarding creation of indirect access permanent 
files, refer to the SAVE command later in this section. 



™' 
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DISPOSE 



See last heading ("Disposing of a File") in Chapter 5. 



GET, lfn=pfn/UN=usernum, 
PW=passwrd 



Retrieves a copy of the specified indirect access permanent file 
(pin) for use as working file. This command can only be used 
for indirect access permanent files. If pfn is omitted, the system 
assumes lfn=pfn. 

If the user wishes to reference the working file by a name other 
than its permanent file name (pfn), the lfn parameter is specified. 
However, if lfn specifies the name of a current working file, the 



TPho nnv- 



^_„4,^_-J._ ^C ±\.~U- fill „ n .£ll 1 KAnlnrtn^ Kit <-l-t£\ rtrtT\I7 r\f Tvftl 

uoiiienta Oi tllm me win uc iciuai.cu uy me w^j Oj. ^"'i 
rent primary file and subsystem in use remain the same unless 
the file name specified for lfn is that of the current primary file. 
In this case, the contents of the primary file is replaced by the 
copy of pfn which becomes the new primary file. Furthermore, 
if pfn has a subsystem flag associated with it (refer to SAVE 
command), that subsystem is selected automatically. For ex- 
ample, assume that file A is the current primary file and the 
user enters: 



( 



LIBRA RY, lfn=pfn/PW= 
passwrd 



GET, A=B 

Then, the copy of permanent file B will become the new primary 
file. If a subsystem other than the one currently active is asso- 
ciated with file B, it is also selected. 

If the request is for a file in another user's catalog (UN keyword 
specified), me peniu»sion muuc \.riii,*\L*, I'mit,, nA^ui^,, ^i.^. , 
is that which the user has been permited for private files or that 
specified in the catalog for semiprivate and public files. 

Retrieves a copy of the specified permanent file from the catalog 
of special user number LIBRARY. This command can only be 
used for indirect access permanent files. 

The permission mode is that which has been granted for private 
files or specified in the catalog for semiprivate and public files. 
The copy of the permanent file retrieved becomes the new primary 
file and all other working files are released unless the next com- 
mand entered is NODROP. 

The ATTACH, GET, or OLD command can also be used to access 
permanent files in the catalog of user number LIBRARY. For 
additional information, refer to LIBRARY command at the end 
of this section. 



OLD, lfn=pfn/UN=usernum, 
PW=passwrd 



Retrieves a copy of the specified permanent file (indirect access 
only) for use as the primary file. If a specific subsystem is as- 
sociated with the file, it is selected automatically. This occurs 
only if the file was originally the primary file and was saved while 
a subsystem other than NULL was active. Refer to the description 
of the SAVE command in this section for additional information. 
All working files are released unless the next command entered is 
NODROP. 
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PERMIT, pfn, usernumj =m 1 , 
usernum 2 =m 2 , . . . ,usernum n = 
m n 

PURGE , pfn/UN=usernum , 
PW=passwrd 



RE PLACE , lfn=pf n/UN= 
usernum, PW=passwrd 



SA VE, lfn=pfn/PW=passwrd, 
CT=n, M=m 



Grants user usernum. permission to access private file pfn. If 
the permission mode, m i( is omitted, the system assumes read 
permission. 

Removes the specified permanent file from permanent file storage. 
If the permanent file does not exist, the system responds 

pfn NOT FOUND. 

WRITE permission is required to purge a permanent file in an 
alternate user's catalog (UN keyword specified). The PW key- 
word must also be specified if the file has a password. It is 
important to note that direct access files are not actually purged 
until the last user accessing the file has released it. However, 
subsequent attempts to access the file will be rejected. 

Allows validated users to replace the contents of a permanent file 
(pfn) with the contents of a working file (lfn). If the file name 
specified for pfn does not exist, a new permanent file is created. 
This command can only be used for indirect access permanent 
files. Note that the REPLACE command does not affect the sub- 
system associated with the permanent file (if any). 

Creates an indirect access permanent file. This command allows 
a validated user to retain a copy of the specified working file in the 
permanent file system. If the optional keywords are omitted, the 
system assumes the following values. 



I 



PW 


None 


CT 


PRIVATE 


M 


WRITE 



Unless the NULL subsystem is active when the primary file is 
saved, an internal indicator called the subsystem flag is set to 
indicate which subsystem is being used. That subsystem becomes 
associated with the permanent file and is selected automatically 
each time the file is retrieved in subsequent requests using the 
OLD command. To save the primary file without a subsystem 
association, the user must enter the NULL subsystem before 
issuing the SAVE command. Note that the subsystem flag is set 
only when saving the primary file. There is no subsystem asso- 
ciation when working files other than the primary file are saved. 

CATLIST COMMAND 

The user may wish to obtain specific information about his permanent files. This can be done with the 
CATLIST command. In addition, this command may be entered if the user wishes to obtain specific 
information about permanent files that he can access in catalogs of alternate users. The following is 
the format of the CATLIST command; the optional keywords (and corresponding parameters) to be in- 
cluded must follow the parenthsis and are order-independent. 

CATLIST (LO=options, FN=pfn, UN=usernum, L=4fn) 

Keyword Option Description 

LO= F Selects a listing of pertinent information about each file in the 

user's catalog (refer to example 1). If an alternate user number 
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Keyword Option 



FP 




(zero) 



FN= 



pfn 



UN= 



usernum 



Description 

is specified (UN keyword), the user obtains a listing of all files 
that he can access in the alternate user's catalog. Note that the 
password for files in an alternate user's catalog is not included in 
the listing. The password to files in an alternate user's catalog 
must be obtained directly from that user (refer to example 2). 

Selects a listing of permission information recorded for each 
alternate user that has accessed a specified file in the user's 
catalog (refer to example 3). This option requires that a file 
name be specified (FN keyword). If an alternate user number is 
also specified (UN keyword), only the permission information re- 
corded for that user of the specified file is listed. 

The user numbers listed include: 

• Those that have been granted explicit permission to the 
file (private file only). 

• Those that have accessed the file because of implicit per- 
mission (semiprivate files only). Permission information 
for alternate users that have accessed public files is not 
recorded. 

Selects a short list that indicates only the names of the files in 
the user's catalog (refer to example 4). If an alternate user 
number is specified (UN keyword), the user obtains only the 
names of the files that he can access in the alternate user's 
catalog. If no LO keyword is specified, the system assumes 
this value. 

Selects a short list that indicates only the user numbers of alter- 
nate users who have accessed the specified private or semiprivate 
file (refer to example 5). This option requires that a file name be 
specified (FN keyword). 

Permanent file name. This option specifies that catalog informa- 
tion is desired only for this permanent file. This parameter is 
required when listing permit information (LO=FP, LO=P). If 
the short list options are selected (LO=0, LOP), the message 

pfn FOUND, 
is returned if the file (or user number) is located. The message 

pfn NOT FOUND. 

is returned if specified file (or user number) is not located. 

User number. This parameter has two purposes. 

For LO=F and LO=0. Indicates the alternate catalog for which 
the user desires catalog information (refer to example 2). 

For LO=FP and LO=P. Indicates the permission information 
recorded for the specified alternate user. 
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Keyword 
L= 



Option 
lfn 



Description 

Output file name. This is the name of a working file to which the 
CATLIST information is written. If this parameter is omitted, 
the system assumes LOUTPUT and the data is returned to the 
terminal. If lfn is a current working file, the CATLIST informa- 
tion is written at the current position in the file. For example, 
if lfn is positioned at the beginning-of-information (BOI), the 
contents of that file is replaced with the CATLIST information. If 
xjn is positioned at end-of-information (EOI), the CATLIST infor- 
mation is appended to the file as a new logical record. 
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CATLIST EXAMPLES 



The following examples illustrate some of the options available to the user when entering the CATLIST 
command (the user entering the command in the examples is USER123). 

Example 1. Listing of pertinent information about each file in the catalog of USER123. The command 
is entered in the form . . . CATLIST/LO=F 



CATALOG OP USER1 23 



73/04/10. 13.41.59. 



FILE NAME ACCESS FILE-TYPE LENGTH DM CREATION LAST ACCESS LAST MOD 
PASSWORD MD/CNT PERM. SUBSYS DATE/TIME DATE/TIME DATE/TIME 



1 DIRFILE 
CDC 

2 DIRT EST 
CDC 

3 ABC 
1234567 

4 TAPE1 



5 PRIME 
ABCDEFG 

6 TAPE 2 



7 BINTAPE 
BINARY 



DIR. 
13 

DIR. 



IND. 
24 

IND. 
20 

IND. 
22 

IND. 
12 

IND. 

8 



PUBLIC 25600 40 

READAP 

PUBLIC 17280 40 

MODIFY 

PRIVATE 1280 

WRITE 

SEMI-PR 640 

READ FORT. 

SEMI-PR 12P0 

READ BASIC 

SEMI-PR 1920 

APPEND BASIC 

PUBLIC 11520 

EXEC EXEC. 



73/01/13. 
19.02.50. 

73/01/13. 
18.59.05. 

73/01/12. 
06.42.13. 

73/01/13. 
19.58.53. 

73/01/12. 
05.38.37. 

73/01/12. 
06.27.00. 

73/01/12. 
06.37.03. 



73/03/23. 
07.33.05. 

73/01/13. 
19.49.40. 

73/03/23. 
07.30.35. 

73/03/23. 
07.30.53. 

73/03/23. 
07.32.19. 

73/03/23. 
07.31.27. 

73/01/13. 
21.42.54. 



73/03/23. 
07.33.05. 

73/01/13. 
19.59.05. 

73/01/13. 
21.16.52. 

73/01/13. 
21.17.54. 

73/02/09. 
13.55.49. 

73/01/13. 
21.20.03. 

73/01/13. 
21.42.54. 



Subsystem flag associated with file when it was 
saved. Blank entry indicates that the NULL sub- 
system was being used or the file was not the 
primary file when the SAVE command was issued. 



4 
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Example 2. Listing of pertinent information about each file that USER123 can access 
in the catalog of USER456. The command is entered in the form. . . 
CATLIST/LO=F.UN=USER456 



CATALOG OF USER1 23 



73/04/10. 13.44.53. 



ALTERNATE CATALOG USER456 
FILE NAME ACCESS FILE-TYPE LENGTH DN CREATION LAST ACCESS LAST MOD 

MD/CNT PERM. SUBSYS DATE/TIME DATE/TIME DATE/TIME 

1 SAMPLE IND. PUBLIC 640 73/01/13. 73/01/13. 7 3/01 /1 3. 

7 EXEC EXEC. 19.28.29. 20.13.30. 19.29.29. 

2 SBMTJOB IND. PUBLIC 1920 73/01/13. 73/02/09. 73/01/13. 

7 READ BASIC 19.22.44. 14.18.51. 19.24.21. 

3 EXAM IND. SEMI-PR 2560 73/01/13. 73/02/09. 73/02/09. 

14 WRITE FORT. 19.29.58. 14.12.08. 14.02.58. 

4 LOG10 DIR. SEMI-PR 25600 * 73/01/13. 73/02/09. 73/01/13. 

6 MODIFY 19.14.06. 14.12.44. 20.29.14. 

5 DEMO DIR. PUBLIC 17280 * 73/01/13. 73/02/09. 73/02/09. 
4 READMD 19.18.52. 14.02.05. 14.02.05. 



DN indicates device number for direct 
access files. * in this column indicates 
file resides on master device (refer to 
glossary for definition). 



Example 3. Listing of permission information recorded for each user that has accessed 
file PRIME (semiprivate file) in the catalog of USER123. The command 
is entered in the form... CATLIST/LO=FP,FN=PRIME 



CATALOG OF USER123 



73/04/10. 13.47.50. 



FILE NAME PRIME 
USER NUMBER PERM. ACCESSES DATE 



TIME 



1. 


USER456 


READMD 


1 


73/01/13. 


20.18.09. 


2. 


JIMALTE 


READMD 


2 


73/01/13. 


20.44.27. 


3. 


DICKOSW 


READMD 


1 


73/01/13. 


20.45.28. 


4. 


EARLDRE 


READMD 


3 


73/01/13. 


20.48.20. 


5. 


CRAIGGE 


READMD 


1 


73/01/13. 


20.49.39. 


6. 


SONYAAN 


READMD 


2 


73/01/13. 


20.51 .37. 
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Example 4. List of current files in the catalog of USER 123. The command is entered 
in the form ... CATLIST/LO=0 (it is not necessary to specify the LO=0 
option since it is the default value). 



CATALOG OF USER1 23 



73/04/10. 13.49.18. 



1ST* T» Mm M*i / M \ 



DIRFILE DIRTEST ABC 
7 PILE(S) 



TAPE1 



PRIME 



TAPE 2 



BINTAPE 



Example 5. List of alternate users that have accessed file DIRFILE in the catalog of 
USER123. The command is entered in the form... CATLIST/LO=P, 
FN=DIRFILE 



CATALOG OP USER123 

FILE NAME DIRFILE 
USER NUMBER(S) 



73/04/10. 13.51.2P. 



USER456 JIMALTE DICKOSW 
3 USER(S) 



ALTERNATE USER ACCESS 

The following examples illustrate the alternatives available for users to access files in 
alternate catalogs. 

PRIVATE FILE CATEGORY 

Working file ABC is retained by USER123 as a private indirect access permanent file 
using the following command. 

SAVE, ABC /PW=1234567 
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The following is the entrv for file ABC in USER123's catalog. The listing is obtained 
by entering the CATLIST" command in the form ... CATLIST /LO=F, FN=ABC 

CATALOG OF USER1 23 73/04/10. 13.53.02. 

FILE NAME ACCESS FILE- TYPE LENGTH DN CREATION LAST ACCESS LAST MOD 
PASSWORD MD/CNT PERM. SUBSYS DATE/TIME DATE/TIME DATE/TIME 

1 ABC IND. PRIVATE 1 280 73/01/12. 73/03/23. 73/01/13. 

1234567 24 WRITE 06.42.13. 07.30.35. 21.16.52. 



User USER123 issues the following command to permit alternate user access. 
PERMIT, ABC, USER456=R,JIMALTE=W 

The following is the permission information recorded in the catalog of USER123. The list- 
ing is obtained by entering the CATLIST command in the form . . . CATLIST /LO=FP, FN =ABC 



CATALOG OF USER1 23 73/04/10. 13.54.18. 

FILE NAME ABC 
USER NUMBER PERM. ACCESSES DATE TIME 



1. USER456 READ 1 73/01/13. 21.29.29. 

2. JIMALTE WRITE 2 73/01/13. 21.32.33. 



The format of the commands required by USER456 and JIMALTE to access the file is: 
GET,ABC/UN=USER123,PW=1234567 or OLD. ABC/UN=USER123, PW=1234567 

Only the following users may access this private file. 

User Information Necessary For Access 

USER 123 File name ABC 

USER456 File name ABC 

File password 1234567 

User number USER123 

JIMALTE File name ABC 

File password 1234567 

| User number USER 123 
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SEMIPRIVATE FILE CATEGORY 

Working file TAPE1 is retained by USER123 as a semiprivate indirect access permanent 
file using the following command. 

SAVE, TAPE 1/CT=SPRIV,M=RE AD 

The following is the entry for file TAPE1 in USER123's catalog. The listing is obtained 
by entering the CATLIST command in the form... CATLIST/LO=F,PN=TAPEl 



CATALOG OF USER1 23 



73/04/10. 13.55.19. 



FILE NAME ACCESS FILE-TYPE LENGTH DN CREATION LAST ACCESS LAST MOD 
PASSWORD MD/CNT PERM. SUBSYS DATE/TIME DATE/TIME DATE/TIME 

1 TAPE1 IND. SEMI-PR 640 73/01/13. 73/03/23. 73/01/13. 

20 READ FORT. 19.58.53. 07.30.53. 21.17.54. 



I 



The following is the permission information recorded in the catalog of USER123. The 
listing is obtained by entering the CATLIST command in the form... CATLIST/LO=FP, 
FN=TAPE1 



CATALOG OF USER1 23 



FILE NAME TAPE1 
USER NUMBER PERM. ACCESSES DATE 



73/04/10. 13.56.18. 
TIME 



1. 


JIMALTE 


READ 


2 


73/01/13. 


21.47.34 


2. 


USER456 


READ 


3 


73/01/13. 


21.48.43 


3. 


DICKOSW 


READ 


1 


73/01/13. 


21.49.53 


4. 


SONYAAN 


READ 


4 


73/01/13. 


21.51.09 


5. 


EARLDRE 


READ 


2 


73/01/13. 


21.53.00 


6. 


CRAIGGE 


READ 


1 


73/01/13. 


21.54.03 



This indicates that six users have accessed file TAPE1 the specified number of times. 
Whenever an alternate user accesses file TAPE1 the first time, the permission infor- 
mation is recorded in the catalog of USER123. Each succeeding access increments the 
access count (ACCESSES). 
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The format of the commands required by all users, except USER123, to access the 
file is: 

GET,TAPE1/UN=USER123 or OLD, TAPE1/UN=USER123 

Users who may access this file are: 

User Information Necessary For Access 

USER 123 File name TAPE1 

All others File name TAPE1 

Password None required 

User number USER123 



PUBLIC FILE CATEGORY 

Working file BINTAPE is retained by USER 123 as a public indirect access permanent 
file using the following command, f 

SAVE, BINTAPE /PW=BINARY, CT=PUBLIC, M=KXECUTE 

The following is the entry for file BINTAPE in USER123's catalog. The list is obtained 
by entering the CATLIST command in the form... CATLIST/LO=F,FN=BINTAPE 



CATALOG OF USER1 23 73/04/10. 13.57.40. 

FILE NAME ACCESS FILE-TYPE LENGTH DN CREATION LAST ACCESS LAST MOB 

PASSWORD MD/CNT PERM. SUBSYS DATE/TIME DATE/TIME DATE/TIME 

1 BINTAPE IND. PUBLIC 11520 73/01/12. 73/01/13. 73/01/13. 

BINARY 8 EXEC EXEC. 06.37.03. 21.42.54. 21.42.54. 



Permission information is not recorded for accesses to a public file. Only the total 
number of accesses to files of this category are recorded for the originator of the file. 

The format of the command required by all users, except USER123, to access file 
BINTAPE is: 

GET,BINTAPE/UN=USER123,PW=BINARY 

or 
OLD, BINTAPE /UN =USER123,PW=BINARY 

Users who may access this file are: 

User Information Necessary For Access 

USER 123 File name BINTAPE 

All others File name BINTAPE 

Password BINARY 

User number USER 123 



t The file category LIBRARY which existed in previous versions of KRONOS remains 
valid for upward compatibility. This category was renamed PUBLIC to avoid confusion 
with the permanent file command LIBRARY. 
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LIBRARY COMMAND 

The LIBRARY command allows access to indirect access permanent files in the catalog of 
special user number LIBRARY. Direct access files may also reside in the catalog of 
user number LIBRARY although an alternate method must be employed to access these 
files (described later in this section). The file category may be private, semiprivate, 
or public. The permission mode is that which has been granted for private files or 
specified in the catalog for semiprivate and public files. 

When the LIBRARY command is entered, a copy of the specified indirect access Per- 
manent file is retrieved. This copy becomes the new primary file and all other work- 
ing files are released unless the next command entered is NODROP. For example: 

LIBRARY, ABC75/PW=13479 

In this example, a copy of the indirect access permanent file ABC 75 is retrieved and 
becomes the new primary file. Note that only indirect access permanent files may be 
accessed with the LIBRARY command. The following commands may also be entered 
to access permanent files in the catalog of user number LIBRARY (differences in com- 
mand function are described). 

• ATTACH, lfn=pfn/UN=LIBRARY, PW=passwrd, M=m 

This command must be entered in order to use any direct access permanent 
files in the catalog of user number LIBRARY. Note that a working file is 
not created since all I/O operations are performed directly on the permanent 
file itself. However, if the user wishes to reference the file by a name other 
than its permanent file name, he may assign a wprking file name (lfn) in the 
command. The primary file name remains unchanged. 

• GET, lfn=pfn/UN=LIBRARY, PW=passwrd 

This command retrieves a copy of the specified indirect access permanent file 
(from catalog of LIBRARY) for use as a working file. The primary file re- 
mains unchanged unless lfn specifies the name of the current primary file (refer 
to description of GET command for additional information). 

• OLD, lfn=pfn/UN=LIBRARY, PW=passwrd 

The function of this command is identical in all respects to that of the 
LIBRARY command. 

The only files that can be accessed from the catalog of LIBRARY are those that allow 
alternate user access. Note that all users, except user number LIBRARY, are con- 
sidered to be alternate users. The rules for alternate user access are summarized as 
follows : 

• Only those users permitted to private files may access them. 

• All users can access semiprivate and public files providing they know the file 
name, password (if one exists for the file), type of access (direct or indirect), 
and user number (LIBRARY). 

The following forms of the CATLIST command may be entered to obtain a listing of 
files that can be accessed in the catalog of user number LIBRARY. 

CATLIST /LO=F,UN=LIBRARY (full listing) 

CATLIST/UN=LIBRARY (file names only) 



if 
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DISPOSING OF A FILE 

The DISPOSE command lets the KEONOS user transmit secondary files to either a batch queue for out- 
put at a central site, or to an EXPOBT/IMPOBT queue for output at a batch terminal. Files disposed 
to a central-site may either be printed, or punched in card deck form. 

For interactive users, the DISPOSE command is an alternative to tying up a relatively slow-speed 
terminal with a lengthy output. It is available under the BATCH subsystem or as a normal conversa- 
tional command. 

To receive a disposed file at a batch terminal, the user logs-in in a normal manner. When the log-in 
is successfully completed, the file is transmitted to the terminal without further action on the part of 
the user. 

The subsequent subsections describe the conventions applying to the DISPOSE command, the disposition 
of a file to a central-site, and the disposition of a file to a batch terminal. 

DISPOSE CONVENTIONS 

The following conventions apply to the use of the DISPOSE command: 

1. The file(s) referenced in the DISPOSE command must be local and non-primary. That is, the user 
must currently be accessing the file as a secondary file. 

/ 2. A file ceases to be under user terminal control once a DISPOSE command is issued. The file is 

released by KRONOS and sent to either the system batch queue (for central-site disposition) or to 
the EXPOET/IMPOET queue (for batch terminal disposition). 

3. A direct access file cannot be disposed. This restriction is applied because issuing a DISPOSE 
command for a direct access file would have the same result is purging it from the system. 

4. A file name must be explicitly referenced in all DISPOSE commands. Unlike other KRONOS 
commands, DISPOSE commands do not assume the user refers to the primary file if a specific 
file name is not entered. NOTE: Primary files cannot be disposed. 

5. Magnetic tape files and common files cannot be disposed. 

DISPOSING A FILE TO THE CENTRAL-SITE 

If a user wants a file sent to the central site, the DISPOSE command takes the following form: 

DISPOSE(lfn=action) (CE) 

or 

DISPOSEafn 1 =action 1 , lfn 2 =action 2 , . . . , lfn n =action n ) (cb) 
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where: 

lfn = name of the file to be disposed. As is indicated, several files can be disposed 
with one DISPOSE command. 

action = how the user wants the file disposed at the central-site. Valid entries indi- 
cating what action should be taken are: 

PE — file should be listed on a central-site printer 
or 
PRB 

PH~file should be punched as Hollerith cards at the central KEONOS site 

PB— file should be punched as binary cards at the central KEONOS site 

P8 —file should be punched as 80-column binary cards at the central 
KRONOS site 

For example, if a user wants to have a file name ADATA printed on a central-site printer, either of 
the following commands could be issued: 



DISPOSE(ADATA=PR) (Q) 



or 



DISPOSE(ADATA=PBB) (cb) 
To dispose the file TESTB to the central-site and have it punched as a Hollerith card deck, the user 



enters: 



DISPOSE(TESTB=PH) (cb) 



DISPOSING A FILE TO A BATCH TERMINAL 

To dispose a file to a batch terminal, the user issues the DISPOSE command in the following format: 

DISPOSEafn=PB/EI=usernum) 
where: 

lfn = name of the file to be disposed 

usernum = the user number which the user will issue when logging-in at a batch terminal. 
NOTE: This number may identify the user who issued the DISPOSE command 
or any other user who will receive the disposed file when it is transmitted to a 
batch terminal. 

For example, if user ABC1234 wants to dispose file PGMTST9 to user DEF5678, the following command 
is entered: 



DISPOSE(PGMTST9=PE/EI=DEF5678) (CB) 



t 
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If a user wants to dispose a file to a batch terminal maintained at the same facility which houses his 
interactive terminal, a short form of the DISPOSE command may be issued: 

DISPOSE(lfn=PEE) 

When the short form of the DISPOSE command is employed, in order to receive the disposed file, it is 
mandatory that the user log-in on the batch terminal under the same user number that was used to 
issue the DISPOSE command. 

Hence, if user ABCI234 wants to dispose file TEST10 to his own in-house batch terminal, he can enter 
either of the following: 

DISPOSE(TEST10=PR/EI=ABC1234) 



DISPOSE(TEST10=PRE) 



( 
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TIME-SHARING JOB PROCESSING 



( 



This section describes various conventions used in time-sharing job processing, as well as facets of 
system operation. 



INPUT/OUTPUT CONVENTIONS 

The following conventions and standards are used for I/O operations at a time-sharing terminal. 

• Standard input lines 

The standard input line entered from the terminal keyboard consists of commands or information 
(program statements, data, or text). Each input line containing information is placed in the primary 
file and must be numbered. A space must ordinarily be inserted between the line number and the 
coding. An exception is the FORTRAN Extended continuation line which has a + immediately after 
the line number. Line numbers for FORTRAN Extended or BASIC programs cannot be more than 
five digits. All other coding can have line numbers up to ten digits. Refer to the description of file 
sorting in section 3 for additional information. 

• Text mode input 

Text mode allows keyboard entry of information into the primary file without specifying line numbers. 
Lines entered in text mode are interrupted as text and are not processed by the system as commands. 
For complete information concerning text mode, refer to the TEXT command described in section-!. 

• Text Editor input 

Normally, keyboard entry of information is possible only to the primary file. However, the Text 
Editor allows the user to enter or modify information in all working files (including the primary file) 
from the terminal keyboard. 

An important feature of the Text Editor is its ability to reference direct access permanent files . 
Since a direct access file cannot be referenced with the OLD command, it cannot become the primary 
file, and normal keyboard entry to the file is therefore impossible. The Text Editor is one method 
that is commonly used to accomplish keyboard entry of source code into a direct access file. The 
following example illustrates the use of the Text Editor to enter source code into an empty direct 
access permanent file from the terminal keyboard (note that a direct access file is empty when it is 
created) . 

DEFINE, DIRFILE 
READY. 
EDIT, DIRFILE 
BEGIN TEXT EDITING 
? ADDS 
ENTER TEXT. 
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? /THIS IS A TEST EXAMPLE TO ILLUSTRATE THE ABILITY TO ENTER 

? TEXT INTO A DIRECT ACCESS PERMANENT FILE DIRECTLY FROM THE 

? TERMINAL KEYBOARD. DATA OR NUMBERED PROGRAM STATEMENTS CAN 

? ALSO BE ENTERED IN THE SAME MANNER. / 

READY. 

? END 

END TEXT EDITING 

SS 0.019SECS. 

READY. 

LNH,F=DLRFILE 

THIS IS A TEST EXAMPLE TO ILLUSTRATE THE ABILITY TO ENTER 
TEXT INTO A DIRECT ACCESS PERMANENT FILE DIRECTLY FROM THE 
TERMINAL KEYBOARD. DATA OR NUMBERED PROGRAM STATEMENTS CAN 
ALSO BE ENTERED IN THE SAME MANNER. 

SS 0.007 SECS. 

READY. 

RETURN, DIRFILE 

READY. 



For complete information concerning the use of the Text Editor, refer to the Text Editor Reference 
Manual. A list of the commands available under the Text Editor is included as Appendix E of this 
manual. 

Although data can be entered into a direct access file from the terminal keyboard, through use of the 
Text Editor, a program can also be used. Since direct access files are normally large in size, a 
program is generally used to manipulate or maintain data on direct access files. 

Length of input/output lines 

If the user attempts to input or output more than 150 characters per line, the additional characters 
merely overprint at the end of the line, unless the terminal being used has an automatic carriage 
return feature. 

Terminate the input line 

The user must terminate each line of input information by pressing the RETURN key. This tells the 
system that the current input line is complete. KRONOS responds by positioning the carriage to the 
beginning of the next line. The user can then enter additional input information on the new line. 

Correct the input line 

Entry errors in the input line can be corrected before the RETURN key is pressed by the use of the 
backspace character. On ASCII code terminals the backspace character is performed by a BACK- 
SPACE key, a CTRLH (simultaneously pressing the CTRL and H keys), or the backarrow key on 



< 



<J 
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some CRT terminals, whichever generates an ASCII BS character. On correspondence code terminals 
the backspace character is the BACKSPACE key. One character (including spaces) Is deleted for each 
backspace character entered. If the beginning of a line is reached, further backspace characters are 
ignored. 

• Delete the input line 

If the user discovers an error in the command or other input just typed, he can delete the current 
input line by pressing the BREAK or CAN (CTRL X ) keys on an ASCII terminal, or the ATTN key on a 
correspondence code terminal. This must be done before the RETURN key is pressed. KRONOS 
ignores the entire input line and responds by printing *DEL* and positioning the carriage to the be- 
ginning of the next line. The following example illustrates the use of the BREAK key. 

NEW, TEST 
READY. 

10 PROGRAM T(OUTPUT) 
20 PRINT 6 

30 6 FORMAT (*THIS IS A TEST*9J *DEL* •« BREAK key pressed j 

40 6 FORMAT (THIS IS IT*) 

50 END 

LNH 

10 PROGRAM T(OUTPUT) 

20 PRINT 6 

40 6 FORMAT (*TfflS IS IT*) 

50 END 

READY. 

• Input to an executing program 

A ? output to the terminal normally indicates that the executing program has requested input. How- 
ever, it should be noted that the program may include question marks in its normal output. Users 
should also note that either after an input request to an executing program, or after the system has 
issued a READY, message, the user has 10 minutes to enter the input data or the next command. 
If the necessary input, or command, is not entered within that time period, the terminal will be logged 
off with a TIME-OUT message. The primary and local files will be retained for an additional 10 
minutes . During that period a recovery may be initiated. 

• Interrupt executing program 

To interrupt an executing program that is currently transmitting output to an ASCII code terminal, 
press the BREAK key.''' If a correspondence code terminal is being used, press the ATTN key. 

This process is commonly referred to as job suspension and is described in more detail in section 7. 



I 
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On some terminals, the equivalent of the BREAK key is the INT or INTRPT key. 
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Terminate executing program 

To terminate an executing program that is currently transmitting output to an ASCII code terminal, 
press the interrupt key. If a correspondence code terminal is being used, press the ATTN key. 
After the system outputs the *INTERRUPTED* message, the user enters the STOP command or any 
other valid command. 

If the program is in execution, but is not actively transmitting output, enter the STOP command to 
terminate the program. 



< 



System messages during input 



The following diagnostic messages can appear at any time during input from the terminal. 



*OVL* 



♦RE-ENTER LAST LINE* 



Line overflow. This message is issued when more 
than 628 characters have been entered since the last 
carriage return (the entire line is lost when the 629th 
character is entered). 

Data was lost during the last line of input or a 
character parity error was returned on a cor- 
respondence code terminal on a network port. 



TERMINAL JOB PROCESSING 



This section explains the basic steps in processing a time-sharing job. These steps include: 

• Terminal log-in 

• Subsystem selection 

• Program entry and execution 

• Terminal log-off 

To use the KRONOS system from a time-sharing terminal, the user must: 

1. Check to ensure that the following switches on the terminal are set to the correct position. Note 
that one or more of the switches listed may not exist on the terminal to be used. However, if that 
terminal has been determined to be acceptable for KRONOS time-sharing operations, its use should 

correspond to that described in this manual. 

• Full-duplex/half-duplex (FDX/HDX) switch. Although this switch can be set to either position, 

it is normally set to the half-duplex position as full -duplex operation is not supported for network 
users. If the switch is set to the full-duplex position, user-generated information will not appear 
at the terminal. 

• Even parity/odd parity switch. If an ASCII code terminal is being used, this switch must be set 
to even parity. Odd parity must be selected for correspondence code terminals. 
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• Baud rate switch. This switch determines the speed at which the termin al transmits and re- 
ceives information. There is only one correct position when the terminal is connected to 
KRONOS. However, this is a system option and is dependent upon the system equipment being 
used. If the correct setting is not known, consult the service vendor. 

2. Dial the KEONOS computer site. If the procedure is unfamiliar, refer to Appendix B for complete 
instructions. When the connecting sequence is complete, KRONOS initiates the log-in sequence in 
the following manner. For 10 and 30 cps ASCII terminals a double slash (//) is typed out. Nothing 
is typed out for 14. 8 cps correspondence code terminals. 

3. Identify your terminal to KRONOS as described below. 

• 10 or 30 cps standard ASCII terminals: 

Perform a carriage return 

• 10 or 30 cps APL ASCII terminals: 

Type A and then perform a carriage return 

• 14. 8 cps correspondence code terminals with standard print: 

Perform a carriage return 

• 14. 8 cps correspondence code terminals with APL print: 

Type A and then perform a carriage return 

The system will then respond by typing out the following: 

NET nnnnnn (This line transmitted to network users only) 

PLEASE SIGN ON-- 

where: 

The NET line defines the network address of the port the user has dialed into. This may be 
referenced in the case of sign on problems. 

4. In response to the sign on request the user should enter only the two-character family name that has 
been assigned to his or her family of permanent files and queues. 

For example: 

PLEASE SIGN ON— KC 

Once the user enters a valid family name, the communications network routes the access request 
to the appropriate central KRONOS system. The KRONOS system indicates that access has been 
established by transmitting the following greeting message: 

yy/mm/dd. hh.mm.ss. 

center serial number KRONOS version 
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where: 

yy/mm/dd. hh.mm.ss . = date and time when communication is established with the central 

system 

center = name of the CYBERNET center being accessed 

serial number = serial number of the central-site computer system 

version = version number that identifies what version of KEONOS is being 
employed at the CYBERNET center in question 

5. After sending the greeting message, KRONOS then requests that the user supply a user number by 
transmitting: 

USER NUMBER: 
Enter your assigned user number on the current line. 
For example: 

USERNUM: US123ER (CR) 
The system responds by printing: 

PASSWORD 



6. Enter your password in the blacked-out area. 
For example: 



A 


B 


C 


D 


E 


F 


G 



If the family name, user number or password are not acceptable, the system responds: 

IMPROPER LOG IN, TRY AGAIN 
USER NUMBER: 

If the user is unsuccessful at logging-in four times in succession, the system issues the message 

ILLEGAL TERMINAL. 

and then disconnects the terminal from the system. 

7. If the user number, password, and system name are acceptable, the system responds: 

TERMINAL: nnn, iii TERMINAL: nnn, iii 

RECOVER/CHARGE: ° T RECOVER/SYSTEM: 



c 



I 
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where; 

nun Terminal number that the system uses as part of the unique identifier for 

each active user. This number is required in certain recovery cases (refer 
to section 7 for a description of terminal recovery). 

iii Terminal type identifier. Can be one of the following: 

TTY ASCII code terminal with standard print 

MEMAPL Memorex 1240 terminal (ASCII code) with APL print 

CORAPL Correspondence code terminal with APL print 

COR Correspondence code terminal with standard print 

713 CDC 713 Display Terminal 

BLKEDIT Block transmission terminal with full display screen 

editing capability (available only on select terminals 
such as the Hazeltine 2000 terminal). 

8. Perform part a or part b of this step depending upon which system response was issued in step 7. 

a. If the RECOVER/SYSTEM: response was issued, enter the subsystem to be used or any valid 
command (refer to sections 4 and 5). 



£ BASIC (CR) To use the BASIC language 

BATCH, nnnnn (CR) To enter control card images interactively from the terminal; 

nnnnn is the field length to be used 



EXECUTE (CRj To execute a previously compiled program 

FORTRAN (CR) To use the time-sharing FORTRAN language 

To BASIC, FORTRAN, or EXECUTE, the system responds: 
OLD, NEW, OR LD3 FILE: 

To BATCH, nnnnn the system responds: 

$RFL, nnnnn. (nnnnn is the specified field length) 

/ 

b. If the RECOVER/CHARGE: response was issued, type CHARGE, followed by a valid charge num- 
ber and project number. 

CHARGE , chargeno , proj ectno (CR) 

The system responds : 

READY. 
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The user then enters the name of the subsystem to be used or any valid command (refer to 
sections 4 and 5). 

To use the BASIC language 

To enter control card images interactively from the terminal; 
nnnnn is the field length to be used 

To execute a previously compiled program 

To use the time-sharing FORTRAN language 

To BASIC, FORTRAN or EXECUTE, the system responds: 

OLD, NEW, OR LIB FILE: 

To BATCH, nnnnn the system responds: 



BASIC (CR) 
BATCH, nnnnn 

EXECUTE (CR) 
FORTRAN (CR) 



$RFL, nnnnn. 

/ 

9. Enter the appropriate file type. 
OLD (CR) 



NEW (CR) 
LIBRARY (CR) 



(nnnnn is the specified field length) 

For a file that was previously saved as a permanent file (the file 
cannot be a direct access file) 

For a new working file 

For an indirect access permanent file that resides in the catalog 
of user number LIBRARY 

The system responds: 

FILE NAME: 
For responses to BATCH requests, refer to section 9. 
10. Enter the file name (one to seven characters). 

lfn (CR) 
If an OLD or LIBRARY file is specified, but does not exist, the system responds: 

pfn NOT FOUND. (pfn is the name of the file requested) 

The user must then return to step 9 and attempt to enter the file type and file name again. 
If no errors are detected, the system responds: 

READY. 



i 
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The following example illustrates a sample log-in, 

// •« (Only on 10 and 30 cps ASCII terminals) 

NET nnnnnn < (Only on network ports) 

PLEASE SIGN ON— KC 

yy/mm/dd. hh.mm.ss. 

EASTERN CYBERNET CENTER SN166 KRONOS 2. 1 

USER NUMBER: USER123 

PASSWORD 



A B C D E F G 



i (The password cannot be seen and is shown in this 

TERMINAL: nnn, iii manner solely for purposes of illustration) 

RECOVER/SYSTEM: BASIC 

OLD, NEW, OR LIB FILE: OLD 

FILE NAME: DEMO 

READY. 

Note that any time the OLD command is used in requests for indirect access permanent files 
(refer to preceding examples), the subsystem need not be specified unless the file requested has 
a NULL subsystem flag associated with it. If the file has a subsystem flag other than NULL as- 
sociated with it (that is, BASIC, FORTRAN, EXECUTE, or BATCH), that subsystem is selected 
automatically. A subsystem flag becomes associated with a file when it is saved (refer to the 
SAVE command in section 5). 

hi the following example, the user logs into the system and requests file DEMO with the OLD 
command. He does not specify a subsystem since he knows that the subsystem flag associated 
with the file causes BASIC to be selected automatically. 

// « (Only on 10 and 30 cps ASCII terminals) 

NET nnnnnn ■* (Only on network ports) 

PLEASE SIGN ON--KC 
yy/mm/dd. hh. mm. ss . 

eastern cybernet center sn166 kronos 2.1 
user number: user123 
password 
|a|b1c[d|e| f' 



G 



TERMINAL: 40.TTY 

RECOVER/SYSTEM: OLD, DEMO ■* The BASIC subsystem flag associated with file 

DEMO causes BASIC to be selected automatically 
READY. 

To ensure that the BASIC subsystem has indeed been selected, the user can enter the ENQUIRE 
command. The system responds: 

TERMINAL: 40.TTY 
SYSTEM - BASIC 
FILE NAME: DEMO 
STATUS - IDLE 
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11. Perform all necessary file creation and/or file retrieval activity. If new BASIC or FORTRAN 
programs are entered, each line must be entered in the proper format and must begin with a 
one- to five-digit line number. Refer to the Time-Sharing FORTRAN and/or BASIC Reference 
Manuals for complete information concerning each language. 

Enter the following command to compile and/or execute a BASIC or FORTRAN program. 

RUN (81 



This command causes the FORTRAN or BASIC program to be compiled and executed. The RUN 
command is also used to execute a program under the EXECUTE subsystem. 

The output of a BASIC or FORTRAN program is in the form: 

yy/mm/dd. hh.mm.ss. 
PROGRAM nnnnnn 

(data requested or gener- 
ated by the program; error 
messages if program errors 
occurred) 

SS 0.032 SECS. T 
RUN COMPLETE. 

If the user wishes merely to compile object code which can be saved and used at a later time, 
he enters the command 

RUN,B=lfn (CR) 

where lfn is the name of the file on which the object code is written. 

If the user wishes to retain the compiled program for later execution under the EXECUTE sub- 
system, the SAVE command must be entered (no subsystem name is retained when a working file, 
other than the primary file, is saved). 

Refer to sections 4 and 5 in this manual for complete information concerning the time-sharing 
commands available to the user. These commands include: 

• Terminal control commands 

• Subsystem selection commands 

• Time-sharing job commands 

• Permanent file commands 

Appendix G of this manual illustrates a sample session at the terminal. 



•The output of SS time (for the preceding activity) after completion of job execution occurs only in the 
BASIC, FORTRAN, and EXECUTE subsystems. The total accumulated SS time since log-in may be 
determined in all subsystems by entering the STATUS, T command. 
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LOG-OFF PROCEDURE 



When the user completes job processing, he logs off the system by typing: 



BYE (CR) 

or 
GOODBYE (CR) 



These commands log the user off the system, release all current working files, and cause the following 
information to be printed at the terminal. 

usernum LOG OFF. hh.mm.ss. 
usernum SS s.sss.SEC. 

where: 

usernum User number 

hh.mm.ss. Current time in hours , minutes, and seconds 

s. sss Number of seconds of system second time used 

The terminal is then disconnected from the system. 

If the terminal is in standard "timeout" status, the user is automatically logged off after 10 minutes 
of no action. If status has been changed to "no timeout," the terminal remains connected until the 
user logs off. (Refer to the LIMITS and TIMEOUT commands in section 4. ) 



ALTERNATE LOG-OFF/LOG-IN 

When the terminal is connected, another user may wish to use the terminal. To log the present user 
off the system and reinitialize the log-in sequence, type: 

HELLO (CR) 

or 
LOGIN (CR) 

The system logs the current user off the system, issues the normal log-off messages, and then auto- 
matically initiates a new log-in sequence. The new user proceeds as described earlier in this section. 



6-11 



1 



ADDITIONAL SYSTEM FEATURES 



\ 



This section contains a description of the program editing, job suspension, and recovery features 
provided for the KRONOS terminal user. 



PROGRAM EDITING 

To allow ease of editing the primary file when working with source programs, KRONOS provides a 
simplified editing capability that can be used under any subsystem.' This capability allows the user 
to: 

• Insert statements into a program 

• Delete statements from a program 

• Correct statements in a program 

The following example illustrates this program editing capability. The user types: 



10 LET A=l (CR) 

20 LET B=50 (CR) 

30 FOR 1=1 TO B <CR) 

40 A=A*I (CR) 

50 PRINT "FACTORIAL" ; I, A (CR) 

60 NEXT I (CR) 

70 END (CI 



If the user wishes to insert a statement between line numbers 10 and 20, he types: 

15 LET Z=20 (CR) 
If the user wishes to delete the statement at line 20, he types: 

20 (ci 



Finally, to change the statement at line number 30, the user types: 
30 FOR 1=1 TO Z (CK) 



*For more detailed editing, the Text Editor should be used. Refer to the Text Editor (EDIT) Reference 
Manual for complete information concerning its use. 
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When the file is listed, it has the following form: 

10 LET A=l 

15 LET Z=20 

30 FOR 1=1 TO Z 

40 A=A*I 

50 PRINT "FACTORIAL" ; I, A 

60 NEXT I 

70 END 

To replace the new version of the file in the permanent file system, use 

REPLACE 
If the user wishes to save a copy of the file under another name, he may enter: 

SAVE,lfn=pm 

Ifn Primary working file name 

pm Permanent file name 

RESEQUENCING LINE NUMBERS 

It is often convenient to resequence the line numbers of the primary file. This is done using the 
following command. 

RESEQ,nn,ii,t (C 

where: 

nn New line number of the first statement (five digits maximum); if omitted the 

system assumes nn=00100. 

ii Increment to be added to nn; if omitted, the system assumes ii=10. 

t Type of file to be resequenced. 

B For files that contain BASIC source code. BASIC statements that 

contain references to line numbers are updated when the line num- 
bers are resequenced. 

T For files that contain text source information. A five-digit line 

number, plus a blank, is added at the beginning of each line. No 
inspection is made for existing line numbers. Thus, if line num- 
bers currently exist, they are not resequenced or deleted and two 
sets of line numbers result. 

D For files that should not contain line numbers. Users who want to 

delete line numbers from their files should enter this parameter. 
NOTE: The space after the line number is also deleted. To ac- 
quire this option, the user simply enters: 

RESEQ,,,D (C 
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other Any number at the beginning of a line is considered a line number 

and is resequenced according to the nn and ii parameters; line 
numbers are added to the beginning of lines where none appear. 

default The user must change to the correct subsystem before entering 

the RESEQ command. 

BASIC programs are resequenced under the BASIC subsystem; 
statements with line number references are updated. Note that 
language errors in the BASIC program may cause faulty rese- 
quencing. 

FORTRAN programs are resequenced under the FORTRAN sub- 
system; statement numbers and references to statement numbers 
are not changed. 

AH parameters supplied in the RESEQ command are order-dependent (must be entered in the order 
they appear in the command). Omitted parameters must be indicated by a comma if other parameters 
are to follow. For example, the command 

RESEQ, 50,, T 

adds line numbers to the primary (text) file without checking for existing line numbers. Thus, the 
first line is numbered 00050 and each succeeding number is incremented by 10 (default value). If the 
T parameter was not specified in the command, the two preceding commas would not have been neces- 
sary. 

If the starting line number (mi parameter) is greater than five digits in length or the increment value 
(ii parameter) causes the line numbers generated to exceed five digits in length, the message 

LINE NUMBER LIMIT EXCEEDED, 
is returned to the terminal. In addition, the message 

RESEQ NUMERIC PARAM ERROR, 
is returned if the user enters a nonnumeric value for either the nn or the ii parameters. 



JOB SUSPENSION 

A user may suspend a job at any time during program execution (after the RUN command has been 
issued). If an ASCII code terminal is being used this is accomplished by pressing the BREAK' key. 
For a correspondence code terminal, the ATTN key is used to suspend a job. The system responds: 

^INTERRUPTED* 



* On some ASCII terminals, the equivalent of the BREAK key is the INT or INTRPT key. 
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A job can also be suspended automatically by the system when: 

• The job has exceeded its time limit (the message TIME LIMIT is provided). The time limit is 
initially set to 100 octal seconds at log-in although the user may change this value through use of the 
SETTL command (refer to description in section 4). 

• A successful recovery has been performed (refer to Recovery later in this section). 

If the job was suspended by the user (interrupted) or by the system after a successful recovery, the 
user may perform one of the following. 

• (CR) Continue (transmit current output). 1 " If the program was transmitting output to the 

terminal when it was suspended, the remaining output is transmitted when this re- 
sponse is made. Note that a portion of the output may be lost. When output is com- 
plete, program execution continues. 

• P (cr) 



Proceed (discard current output). If the program was transmitting output to the ter- 
minal when it was suspended, the remaining output is discarded and program execu- 
tion continues when this response is made. 

• STOP (CR) Terminates the job. 

• other Terminates the job. 

If the job was suspended because it exceeded its time limit (TIME LIMIT message issued), the user 
may respond as follows: 

• T,nnnnn @ Increment central processor time limit by nnnnn (number of octal seconds). When a 

job exceeds its time limit, this response is required to continue job execution. Any 
other input will terminate the job. 

The following example illustrates the use of the BREAK or ATTN key to interrupt a program. 

LNH 

00100 REM TEST FOR I KEY 

00110 FOR 1=1 TO 100 

00120 PRINT I 

00130 NEXT I 

00140 INPUT A, B 

00150 PRINT A, B 

00160 END 

READY. 

RNH 
1 

2 
3 

4 
5 

-< . 



-The job is interrupted by the BREAK or ATTN key. 



t If the TAPE command is in effect (tape mode), carriage return is ignored when entered on an empty 

input line. P followed by a carriage return must be issued to resume execution. 
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*INt£RRUPTED. * 

■4 The user continues by pressing the carriage return key (some 

25 output was lost). 

26 
27 
28 
29 
30 
31 
•4 The job is again interrupted by the BREAK or ATTN key. 

♦INTERRUPTED. * ^-^ 

p -4 The user continues execution of the job by entering P (cr) (all 

output generated but not yet transmitted to the terminalwhen the 
? 2,7 interrupt occurred is discarded). 

2 7 

SS 0. 105 SECS. 

In the following example, a program exceeds its allocated time limit. The program then runs to com- 
pletion when a new time limit is entered. 

RECOVER/SYSTEM: FORTRAN, OLD, NM 
READY. 

LNH 

00100 PROGRAM T (OUTPUT) 

00110 DO 6 1=1, 1000 

00120 DO 6 J=l, 1000 

00130 A=l 

00140 6 CONTINUE 

00150 END 

READY. 

SETTL, 10 

SS 0.001 SECS. 

READY. 

RNH 

TIME LIMIT. 
T.1000 

END. 

SS 15.421 SECS. 

RUN COMPLETE. 



7-5 



i 



RECOVERY 

During job processing, recovery may be necessary when: 

• The terminal has been accidentally disconnected from the system 

• A system malfunction has occurred which requires a restart 

The USer iS nlaCfld in VfimVfinf Btn + Q w1lon£ro-OT> hi ic dicnnnnnnf/sJ 4W.n* «,„ J. ..Jil j. 1. ■-—•__. <!S 

— i . — j ,.«»»»w»w» «~ i^ uiowuu S vi.cu J.J.U111 nic ovBteiu wiuioui logging on, 

providing that he is not already in recovery state. The user is given 10 minutes to initiate recovery. 

In order to recover, a user completes the log-in sequence to the point where the system requests 
RECOVER/SYSTEM: (or RECOVER/CHARGE:). For example: 

// 

NET nnnnnn 

PLEASE SIGN ON--KC 

yy/mm/dd. hh.mm.ss. 

EASTERN CYBERNET CENTER SN166 KRONOS 2.1 

USER NUMBER: USER123 

PASSWORD 



TERMINAL: 15.TTY t Terminal number/type identifier 

RECOVER/SYSTEM: 

In response, the user enters: 

RECOVER, nnn (c^) 

where: 

nnn Terminal number being used when the failure occurred. This number was 

indicated when the user initially logged-in (refer to preceding example). If 
the same terminal number is indicated when the user logs-in to recover, this 
parameter is not required. 

The RECOVER command is valid only when entered in response to the RECOVER/SYSTEM: or 
RECOVER/CHARGE: request during the log-in sequence. If the user's terminal number is not the 
same as before the failure, the previous terminal number must be entered with the RECOVER command 
(nnn parameter). This may occur when the failure is due to a dropped line connection. In this case, 
a different terminal number may be assigned at log-in because of telephone switching rotaries. If the 
RECOVER command is not entered where indicated, the user may log-off, log-in again, and then enter 
the RECOVER command correctly. 

If the system responds RECOVERY IMPOSSIBLE, one of the following conditions has occurred. 

• No record was found of the specified user being logged-in on the given terminal number within the 
past 10 minutes. 

• The user's system information was incorrect due to system malfunction. 
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If the user receives this message, he should check the terminal number he has entered. If he finds he 
has not given the correct number, he may reenter RECOVER with the correct terminal number. 

IE recovery is successful, the system responds: 

RECOVERED - PRESS RETURN KEY TO CONTINUE 
LAST COMMAND - nnnn 
NEXT OPERATION - 

yyyyy 



nnnn 



yyyyy 



Name of last command processed. If source code was being entered, the word 
SOURCE is output. 



One of the following messages : 

Message 
IDLE. 

INPUT REQUEST. 
OUTPUT AVAILABLE. 
EXECUTING. 
REENTER COMMAND. 

REENTER INPUT. 
SORT. 



Description 

No activity. 

Job is awaiting input data. 

Output data is available. 

Job is active with no output. 

Last command was not processed. The user 
should reenter the command. 

X nt5 1.&1£>L line Ul lixpuu iaclIci vvcib j.u&*». 

The primary file is waiting to be sorted. 



If the message FILES LOST is also issued, one or more working files was lost, 
on system malfunction. 



This would occur only 



The user must then issue a carriage return to restart his job. If the job was previously transmitting 
output, the output data normally resumes a few lines prior to where the interruption in service occurred. 

In general, recovery in the KRONOS system has been designed to provide minimum inconvenience to 
the user with a maximum of security. It should be realized, however, that under certain conditions 
recovery of user information cannot be perfect. The following are two examples of these circumstances. 

• In some cases, a few lines of output may be lost when a phone line is disconnected just as a job is 
being restarted to generate more output. This actually occurs before current output is exhausted. 

• If a phone line is disconnected when a user is entering source code, he can normally expect to lose 
the last few lines of text he has entered. 

It is possible to recover two or more users having the same user number because both the user number 
and ter minal number are used to uniquely identify each active user. Whenever the user number and 
terminal number of a user who must be placed in recovery state match the user number and terminal 
number of a user already in recovery state, the latter «ser is logged off. Sf a user is disc o nne cte d 
after logging in, but before he can recover from a previous disconnect, the latter time is processed as 
a normal log-off. This is to protect the user from an intermittent phone line failure. The user may 
then log-in again and enter the RECOVER command to continue his job. 
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An example of a normal recovery is : 

// 

NET nnnnnn 

PLEASE SIGN ON--KC 

yy/mm/dd. hh.mm.ss. 

EASTERN CYBERNET CENTER SN166 KRONOS 2.1 

USER NUMBER: USER123 



TERMINAL: 16,TTY 

RECOVER/SYSTEM: RECOVER, 12 

RECOVERED - PRESS RETURN KEY TO CONTINUE 

LAST COMMAND - RUN 

NEXT OPERATION - 

IDLE. 

The user presses the carriage return key to continue job processing. 

The following example illustrates a sample recovery. 

// 

NET nnnnnn 

PLEASE SIGN ON--KC 

yy/mm/dd. hh. mm. ss . 

EASTERN CYBERNET CENTER SN166 KRONOS 2.1 

USER NUMBER: USER123 

PASSWORD 



TERMINAL: 15,TTY 

RECOVER/SYSTEM: FORTRAN, OLD, A A 
READY. 

LNH 

10 PROGRAM AA(INPUT, OUTPUT) 

20 PRINT 4 

30 4 FORMAT(*ENTER 2 NUMBERS*) 

40 READ, A, B 

50 C=A*B 

60 PRINT 5 

70 5 FORMAT(*A X B=*) 

80 PRINT, C 

90 END 

READY. 

RNH 

ENTER 2 NUMBERS 

•* — The user is disconnected and logs in again. 



i 
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// 

NET nnnnnn 

PLEASE SIGN ON— KC 

yy/mm/dd . hh . mm . s s . 

EASTERN CYBERNET CENTER SN166 KRONOS 2.1 

USER NUMBER: USER123 

PASSWORD 



i 



TERMINAL: 15, TTY 

RECOVER/SYSTEM: RECOVER 

KECUVEKJUJJ - ir-ltEoS KZ. ± u ruN rvci ±kj <^vjjN j. jjN uii. 

LAST COMMAND - RNH 
NEXT OPERATION - 

INPUT REQUEST. 

+ The user presses the carriage return key to con- 
tinue. 
? 4,5 
AXB= 

20.00 
END 

SS 0.004 SECS. 

RUN COMPLETE. 

This example illustrates another recovery situation. 

STATUS 

TERMINAL: 32, TTY 
SYSTEM - BASIC 
FILE NAME: BB 
STATUS - IDLE 

LNH 

10 REM THIS IS A TEST 
20 REM PRINT B 
30 PRINT "PRINT B" 
40 LET B=l-f3 
50 PRINT B 
60 END 
READY. 
A " 



The user is disconnected. 



// 

NET nnnnnn 

PLEASE SIGN ON--KC 

yy/mm/dd. hh. mm. ss . 

EASTERN CYBERNET CENTER SN166 KRONOS 2. 

USER NUMBER: USER123 

PASSWORD 



TERMINAL: 32, TTY 

RECOVER/SYSTEM: 

^ . — The user is disconnected before recovering. 

This is processed as a normal log-off. 
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// 

NET nnrmnn 

PLEASE SIGN ON--KC 

yy/mm/dd. hh . mm . s s . 

EASTERN CYBERNET CENTER SN166 KRONOS 2.1 

USER NUMBER: USER123 

PASSWORD 

TT? T?TVJT\T A T . Q9 T^-V 

x uiuiiuiiiij, u.u • J. X J. 

RECOVER/SYSTEM: RECOVER, 32 -« The user enters the RECOVER command. 

RECOVERED - PRESS RETURN KEY TO CONTINUE. 
LAST COMMAND - LNH 
NEXT OPERATION - 
IDLE. 

•♦ ■ The user presses the carriage return key to con- 

tinue 
LNH 

10 REM THIS IS A TEST 

20 REM PRINT B 

30 PRINT "PRINT B" 

40 LET B=l+3 

50 PRINT B 

60 END 

READY. j- 
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REMOTE JOB ENTRY 8 



Remote job entry is a feature of KRONOS that enables a validated, time- sharing user 
to submit batch job deck images to the system for processing. The batch job image 
„„., k~ n «!i 9 fDri infaKaniiuoiv at tVi *» Hrn p- sharin g. terminal and then submitted to the 
local batch queue by entering the SUBMIT command. The user is no longer interactive 
with the job once it has been submitted. Instead, the job is treated in the same manner 
as a job submitted from the card reader at the local computer site or from a remote 
batch terminal (EXPORT/IMPORT). The batch job image can consist of control card 
images, KRONOS control language (KCL) statements, program statements, and data. 
The structure of the batch job image must also be the same as its counterpart on 
cards (job deck). The user can specify how the job is to be structured through use 
of the reformatting directives described in this section. Refer to the KRONOS Refer- 
ence Manual for information concerning job structure and a description of the batch 
control cards and KCL statements available. 

The format of the SUBMIT command is: 

SUBMIT(lfn,q, NR)c 

Where: 

<lfn Name of file to be submitted to KRONOS for processing as a deferred 

batch job. If lfn is omitted, the primary file name is assumed. In 
this case, the primary file is sorted before being submitted, rermanent 
files may also be submitted but first must be associated with the job via 
the OLD, GET, or ATTACH command. 

q Specifies disposition of job output as follows: 

B Job output is disposed to local batch queue to be printed, punched, 
etc. , at the central site. 

N Job output is disposed to local batch queue, but is dropped at job 
termination (default value). 

E Job output is disposed to EXPORT/ IMPORT queue for printing at 

a remote batch terminal. 

NR No rewind option; inhibits rewind of file specified by reformatting directive 

cREAD (refer to Reformatting the Submit File later in this section). If 
omitted, file specified by cREAD directive is automatically rewound. 

c Escape character used to identify reformatting directives in the file to 

be submitted (lfn). If omitted, the system assumes c=/. 
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After the job has entered the local batch queue, the system responds: 

hh. mm. ss. jobname 
READY. 

Where: 

hh. mm. ss. Time that the job entered the batch queue (hours, minutes, seconds. ) 

jobname Job identification. NOTE: The third character from the right in the job- 

name will represent the day of the month (in display code). 

The job identification is entered with the STATUS, J=jobname command to obtain the status of a job 
once it has entered the system. Refer to the description of the STATUS, J command in section 4 for 
additional information. 

REFORMATTING THE SUBMIT FILE 

The submit file (tfn in the SUBMIT command) is a file which contains the batch job image submitted to 
KRONOS for processing. The reformatting directives described in this section are provided to aid the 
user in preparing the submit file. When the SUBMIT command is entered, the submit file is refor- 
matted according to the directives that appear in the file and is then placed in the batch input queue 
awaiting execution. Thus, several of the directives are provided to format the submit file to meet the 
structural requirements of a batch job (refer to section 3 in the KRONOS Reference Manual). 

Each line in the submit file preceded by an escape character is recognized by KRONOS as a reformat- 
ting directive. The escape character to be used must be defined in the SUBMIT command (/ by default). 
Throughout this description, the letter c, preceding a directive, denotes the escape character. Refor- 
matting directives may be interspersed throughout the submit file as long as transparent mode is not in 
effect. Transparent mode is selected by the cTRANS directive and requires that the user observe 
special rules when inserting subsequent directives into the file (refer to the description of cTRANS and 
cNOTRANS directives). 

It is important to note that reformatting directives will not be processed unless the first line of the 
submit file contains the cJOB directive. In addition, the first two card images following the cJOB 
directive (second and third lines of the submit file) must be a JOB and ACCOUNT card, respectively. 
All following information is determined by the user. Thus, the first three lines of a submit file that is 
to be reformatted before processing should be: 

00100 cJOB 

00110 JOBNAME, . . . * JOB card image 

00120 ACCOUNT, usernum . passwrd , family . < ACCOUNT card image 
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NOTE 

The JOB and ACCOUNT cards are required in all 
batch jobs and must be present even though the 
cJOB card is omitted. 

Although text mode may be used to create a submit file, it is not necessary since each 
line may or may not have a leading line number. The cSEQ and cNOSEQ directives 
are used to determine, during reformatting, if line numbers in the submit file will be 
retained. Therefore, it is a simple matter to include line numbers on the entire submit 
file and specify which line numbers are to be removed during reformatting. This is 
especially useful if the submit file contains a BASIC program where line numbers are 
a requirement of the language. 

The reformatting directives available are described as follows: 



cJOB 



Indicates that the submit file is to be reformatted and selects the following 
default reformatting directives. The default directives remain in effect 
until specified otherwise. 

cNOTRANS (disabled by cTRANS) 
cSEQ (disabled by cNOSEQ) 

cPACK (disabled by cNOPACK) 



The cJOB directive must be the first line of the submit file, 
the file is not reformatted. 



If omitted, 



cEOR Indicates that an end- of- record mark is to be placed at this point in the 

submit file during reformatting 

cEOF Indicates that an end-of-file mark is to be placed at this point in the 

submit file during reformatting 

cSEQ Indicates that line numbers will be removed from all subsequent lines 

during reformatting (default value) 

cNOSEQ Reverses the effect of the cSEQ directive. No attempt is made to remove 

leading line numbers from subsequent lines. 

cPACK Indicates that all succeeding internal EOR and EOF marks be removed 

during reformatting (default value). This directive applies only to internal 
EOR and EOF marks that currently exist. The cEOR and cEOF reformat- 
ting directives are not affected. 

cNOPACK Reverses the effect of the cPACK directive. Requests the system not to 

discard succeeding internal EOR and EOF marks that currently exist. 

cTRANS Indicates transparent mode. When encountering this directive during 

reformatting, KRONOS checks the next line of the submit file for an 
additional reformatting directive. If one exists, it is processed and the 
following line is checked. This continues until a line that does not 
contain a reformatting directive is encountered. Transparent mode is 
then selected and all directives that exist on subsequent lines are ignored 
until an internal EOR or EOF, is encountered (not cEOR or cEOF). The 
cPACK and cNOPACK directives determine if the internal EOR or EOF 
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cNOTRANS 



will be retained. The line following the internal EOR or EOF mark 
is then checked for a reformatting directive. If one exists, it is 
processed and the following line is checked. All directives are 
processed until a line that does not contain a reformatting directive 
is encountered. This causes transparent mode to be reset unless a 
cNOTRANS directive was encountered. This process continues until 
either the end of the submit file is reached or until a cNOTRANS 
directive following an internal EOR or EOF is encountered. 

The c TRANS directive is typically used in conjunction with the cREAD 
directive. This allows the user to copy the contents of an existing 
file into the submit file at the location of the cREAD directive. Be- 
cause the file is read in transparent mode, no check for reformatting 
directives is attempted until an internal EOR or EOF is encountered. 
Note that the cREAD directive must follow the c TRANS directive and 
must be located before the first succeeding line that is not a reformat- 
ting directive. If not, transparent mode is selected before the 
cREAD directive is encountered, and the cREAD will be ignored. 

The cSEQ or cNOSEQ directive in effect before transparent mode 
was selected has no effect upon the submit file or the file being read 
(cREAD) while transparent mode is in effect. Note, however, that 
the cPACK or cNOPACK directive in effect before transparent mode 
was selected remains in effect after it is selected. 

Reverses the effect of the cTRANS directive and informs the system 
that the submit file is to be examined on a line-by-line basis. All 
directives encountered in the submit file while the cNOTRANS direc- 
tive is in effect are processed. This directive is initially selected 
by default and remains in effect until a cTRANS directive is en- 
countered in the submit file. 



i 



Caution should be observed in the placement of this directive in the 
submit file. If transparent mode is selected, this directive can 
possibly be ignored unless it immediately follows either a cREAD 
directive in the submit file or an internal EOR or EOF mark. 

cREAD.lfn Requests that the system read the entire contents of the specified file 
(lfn) and insert that file, in place of the cREAD directive in the submit 
file, during reformatting. If the file to be read is not currently 
attached to the user, KRONOS automatically attempts a GET and 
then an ATTACH on the file. If lfn is not specified in the directive, 
TAPE1 is assumed. If the file specified cannot be found, the message 

NO READ FILE - lfn 

is issued to the job dayfile, and the job is terminated. If the read 
file is found to be busy (direct access files only), the message 

READ FILE BUSY - lfn 



is issued to the job dayfile and the job is terminated. The file 
specified by lfn in the cREAD directive is automatically rewound 
before the read operation unless the NR parameter is specified in 
the SUBMIT command. In this case, the cREWIND directive must 
precede the cREAD directive in the submit file if it is desired to 
rewind file lfn before the read operation begins. KRONOS returns 
all files specified in cREAD directives before completion of the job. 
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If the cPACK directive is in effect at the time of the read, all 
internal EOR and EOF marks will be removed. If the cNOPACK di- 
rective is in effect, all internal EOR and EOF marks are read into 
the submit file in the proper position during reformatting. 

Unless transparent mode is in effect when file lfn is read, each line 
of that file is also checked for a reformatting directive. Any direc- 
tives contained in the file, except another cREAD, are processed. 
The cREAD directive cannot be nested. In addition, any directives 
in effect before the cREAD directive is processed remain in effect 
for the file being read, unless transparent mode is selected. Then, 
only the cPACK or cNOPACK directives remain in effect for the 
file being read. Moreover, only those directives that immediately 
follow an internal EOR or EOF in the file being read are processed. 
If the file to be read is a binary file, it is recommended that the 
cTRANS directive be used. This is to ensure that binary data will 
hot be mistaken for a reformatting directive. If used, the cTRANS 
directive should immediately precede the cREAD directive in the 
submit file. 



L 



cREWIND, Requests that the system rewind file lfn to the beginning- of- information, 
lfn (BOI). If lfn is not supplied, TAPE1 is assumed. This directive is 

required only if the NR parameter is included in the SUBMIT command. 

Otherwise, file lfn is automatically rewound. 

This directive is used in conjunction with the cREAD directive. Thus, 
if it is desired to rewind a file before the read operation begins, this 
directive must precede the cREAD directive in the submit file. 

Indicates that the escape code character is to be changed from cj 
(current escape code) to C2 (new escape code). The new escape code is 
used to recognize all subsequent reformatting directives until further 
change. 



ERROR PROCESSING 

If the user determines that an error occurred during processing of his job, he may 
reference a listing of the job dayfile as an aid in identifying the cause of the error. 
The job dayfile contains a record of the job processing activity and is disposed to the 
local batch queue or the EXPORT/IMPORT queue for printing when the job is terminated. 
However, all output is normally dropped at job termination when a batch job image is 
submitted from a time-sharing terminal. This includes the dayfile output as well as 
the job's output. In this event, the user can make provisions within his job to save 
the contents of the dayfile if an error in processing occurs. This is done by including 
the following control card images at the end of the job's control record (first record 
of the submit file). 



00562 EXIT. 

00563 DAYFILE, lfn. 

00564 REPLACE(lfn) 
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When an error condition occurs during job processing, the system searches the job's 
control record for an EXIT card. If an EXIT card is found, the error condition is 
cleared and the control card images that follow are processed. In this cade, the 
contents of the job dayfile is copied to the working file specified by lfn. That file 
is then saved for future reference. 

If an error does not occur during job processing, the EXIT card indicates where to 
terminate normal control card processing. 
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BATCH SUBSYSTEM 



The BATCH subsystem provides the time-sharing terminal user with a capability to 
enter KRONOS batch control card images as well as the standard time- sharing commands 
described in this manual. The control card images are entered and processed one at 
a time, and all output is returned to the terminal unless otherwise specified. Refer to 
the KRONOS Reference Manual for a description of the batch control cards available and 
information concerning their use. 

To enter the BATCH subsystem, the user types: 

BATCH, nnnnn 



( 



Where: 

nnnnn 



Amount of field length required for the control card images to be 
entered. If nnnnn is not specified, a default value of 20000B is 
assumed. Note that an RFL control card image can be entered 
at any time to specify a new field length. 

Many of the system utilities and file manipulation control cards 
(for example, COPYBF and SKIPF) run at a predefined field length 
rather than the field length specified in the BATCH command. How- 
ever, all other control cards use the field length specified in the 
HA itjM command or o,y a auosequeni, rvb j_i i;unirui ^a±^. xne iifcj.^ 
length required for the product set control cards (for example, 
COMPASS) is listed in the KRONOS Reference Manual. 



The system responds: 

$RFL, nnnnnn. (nnnnn is the specified field length) 

/ 

The user may then enter any valid batch control card image or time- sharing command. 
Time-sharing commands cannot be abbreviated under the BATCH subsystem; the entire 
command or control card must be entered to be valid. The user may also end each 
control card with a period, but this is not required since the system automatically 
terminates each line of batch input with a period. If the command or control card is 
not valid or is entered incorrectly, the system responds: 

ILLEGAL CONTROL CARD. 

CATLIST and DEFINE permanent file commands are always processed as batch 
commands. 

The remaining permanent file commands are processed as time- sharing commands 
unless preceded by an X (refer to the following paragraphs), in which case they are 
also processed as batch commands. When a command is treated as a batch command, 
its operation will depend on a previously entered ACCOUNT card. 
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Initially, when a control card image is entered at the terminal, the time-sharing 
executive routine attempts to process it as a time- sharing command. Under the BATCH 
subsystem, if a command cannot be interpreted by the executive routine, it is passed 
to the system as a control card. A command that cannot be interpreted is either not 
in the time- sharing command set or is too complex to be processed by the executive 
routine. For example, the command 

GET, A 



is a valid time-sharinrr r.nmmanri nnH /^an ho Tv»n»ae 
GET, A, B, C,D 



However, the command 



cannot be interpreted by the time-sharing executive routine and is thereby passed to the 
system for processing as a control card. If the user desires that a valid time- sharing 
command be processed as a control card, he may enter the following command (avail- 
able only under the BATCH subsystem): 

X, ccccccc 

This command allows the user to force a valid time- sharing command (ccccccc) 
normally interpreted by the executive routine, to be processed by the system as' a 
control card. For example, to call the BASIC compiler, the user enters 

X, BASIC 
rather than the command 

BASIC 

which would change the subsystem from BATCH to BASIC. 

To exit from the BATCH subsystem, the user must type the entire name of one of the 
other subsystems (FORTRAN, BASIC, EXECUTE, or NULL). It is important to note 
that the user may also change the subsystem unintentionally by entering the OLD 
command. The OLD command is used to obtain a different primary file, but may 
also select the subsystem that was active when the specified file was originally saved 
Refer to the description of the SAVE command in section 5 for additional information.' 

NOTE 

Although a user can enter any batch control card 
from a time- sharing terminal, the output produced 
by several of these cards is formatted for trans- 
mission to a line printer (136 characters per line). 
Through use of the L072 control card, the user 
can format the output for transmission to a time- 
sharing terminal (72 to 150 characters per line). 
Refer to the description of the L072 control card 
in section 5 of the KRONOS Reference Manual. 
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Although the user is not expressly prohibited from entering the ACCOUNT control card, the results 
of permanent file operations, after doing so, may prove unpredictable. In addition, the new user num- 
ber specified on the ACCOUNT card may also require entry of a charge number and project number to 
be valid. 

The following are circumstances when time-sharing commands (that reference a user number or a 
user's permanent file catalog) are processed under the user number specified in the most recent 
ACCOUNT card entered. In all other cases, commands are processed under the user number speci- 
fied at log-in. 

1. Time-sharing commands that cannot be processed by TELEX due to format (for example, GET, A, 
B,C; PURGE,A,B,C). 

2. Time-sharing commands (such as DEFINE, CATLIST, etc. ) for which no processing capability 
exists under TELEX are always processed by the system as control cards. 

3. Time-sharing commands preceded by "X," are processed by the system as control cards so long as 
there exists a control card of the same name (for example, ATTACH, GET, etc.). 



Example: 



// 

NET nnnnnn 

PLEASE SIGN ON--KC 

yy/mm/dd. hh. mm. ss . 

EASTERN CYBERNET CENTER SN166 KRONOS 2.1 

USER NUMBER: ALPHA 

PASSWORD 



TERMINAL: 32,TTY 

RECOVER/SYSTEM: BATCH 

$RFL,2000 

/ACCOUNT, BETA 

/DEFINE, ABC 

/CATLIST 



/RETURN, ABC 
/ATTACH, ABC 

ABC NOT FOUND 



(This will list the permanent files of BETA and will 
include the direct access file ABC) 



Explanation: 

The user logs in under his user number ALPHA. He then enters the ACCOUNT command for an alter- 
nate user with user number BETA. Then he defines a direct access file ABC. He enters a CATLIST 
command which gives a listing of the permanent files for BETA rather than ALPHA. This is because 
CATLIST references the user number on the last ACCOUNT command rather than the one used for 
log-in. 

The user enters a RETURN. Then he tries to attach ABC and receives the message 



ABC NOT FOUND 

The file is not found since the ATTACH command references the log-in user number (ALPHA) and this 
file is catalogued under the ACCOUNT card user number (BETA). 
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GLOSSARY 



Alphanumeric 



Answerback coae 



APL 



ASCII 



Auxiliary device 

BASIC 

Catalog 

Compile 

Control card 
Direct access file 

Display code 



A combination of intermixed alphabetic and numeric 
characters. 

A character code which uniquely identifies a tele- 
typewriter unit. If this code is present in the 
user's validation file, the user's activities are 
limited to this particular unit. The code is set 
on a drum within the TTY. KRONOS checks only 
the first ten characters. 

A Programming Language. An interactive inter- 
preter available to the time-sharing user. 

American National Standard Code for Information 
Interchange; the 128-character set utilized by KRONOS 
for the terminal user. 

Mass storage permanent file device used to supple- 
ment storage provided by the normal permanent 
file devices associated with the system (refer to 
family device). 

Beginner's All-purpose Symbolic Instruction Code; 
an elementary programming language available to 
the KRONOS user. 

The list of permanent files saved under a particular 
user number; this list also contains information 
about the permanent files. 

To translate a program from a higher level program- 
ming language (for example, FORTRAN or BASIC) 
into machine instructions. 

Instruction to the operating system to perform a 
specified task or utility. 

A permanent file which can be attached to the user's 
job. All changes to this file are made on the file 
itself rather than to a working copy of the file. 
(Refer to indirect access file. ) 

An internal code set used by CDC CYBER 70 series 
and 6000- series computers to represent alphanumeric 
and special characters. (Refer to Table B-2 in 
appendix B. ) 
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EOF 

EOI 

EOR 



End- of- file 

End- of- information 

End- of- record 



These represent the 
method by which files are 
defined and structured. 
Refer to the discussion 
in section 3. 



Familv device 



Field length 
File 

Flag 
FORTRAN 

Indirect access file 

Interactive 



Library file 

Local file 

Locked file 
Logical record 



a specific KRONOS system. A family may consist 
of 1 to 63 logical devices. Normally, a system 
runs with one family of permanent file devices 
available. However, additional families may be 
introduced during normal operation. This enables 
the users associated with the additional families 
to access their permanent files via an alternate 
system. 

Number of central memory words required to 
process a job. 

Either a program or data, made up of one or more 
groups of data separated by EORs and EOFs and 
terminated by an EOI. 

A character or bit that signals the occurrence or 
presence of a particular condition. 

The FORmula TRANslation compiler that converts 
algebraic and scientific problems into machine 
language instructions. 

A permanent file which is accessed by use of a 
working copy of the file rather than by working on 
the file directly. 

Job processing in which the user and the computer 
communicate with each other, rather than the user 
merely submitting his job, receiving output, and 
having no control over the job while processing 
occurs. 

A permanent file residing under the special user 
number LIBRARY. 

Any file assigned to a user while he is logged in 
at a terminal. Same as a working file. 

A file on which a user cannot write. 

A record whose length is a function of the infor- 
mation it contains rather than the device on which 
it is stored. 
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Master device 

Object code 

On-line 

Order- dependent 

Order- independent 

Parameter 
Permanent file 

Permanent file family 

Physical record unit (PRU) 

Port 

Post radix 

Prefix character 

Primary file 



Mass storage device that contains the user's per- 
manent file catalog, all his indirect access files, 
and all, part, or none of his direct access files. 



An 



Executable machine language instructions. ..... 

object code program need not be recompiled each 
time it is executed. 



Private auxiliary device 



Equipment under direct control of the computer. 

Items which must appear in a specific order. 

Items which need not be given in any specific order. 
Parameters may be order- independent. For 
example, the UN=usernum parameter in the GET 
command is order- independent. 

A variable that is given a specific value for a 
particular purpose or process. 

A file which is created by a user, stored under 
his user number in the permanent file system, and 
is removed from permanent file storage only when 
specified by the user. 

Permanent files which reside on the family devices 
of a specific KRONOS system. 

The standard unit of data storage defined by the 
device on which a file resides. 

The point at which a communication line is attached 
to the computer system. 

A letter following a numeral that indicates the base 
numbering system. 

A character that has a special significance to a 
program or the operating system. 

Any working file defined with the OLD and LIBRARY I 
command or initiated with the NEW command. The I 
primary file is assumed to be the file on which 
most operations are performed unless another file 
is specified. The primary file is automatically 
sorted by the system and rewound after each use. 

Auxiliary device associated with a specific user. 
Only that user may create files on the device, 
although he may permit other users to access files 
which reside on the device. 
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Public auxiliary device 



Rollout file 
Rubout characters 

Source code 

Swapping 

System file 

System utilities 
Time slice 

TTY 
Validation file 

Working file 



Auxiliary device available for access by all validated 
users knowing the correct packname. Note that 
additional validation is required to create or replace 
files on an auxiliary device (refer to LIMITS com- 
mand in section 4). 

A file containing a job (and system information) 
that has been temporarily removed from the main 
processing area of the system. 

Characters created by pressing the RUBOUT key 
on the terminal. These are considered null input 
by the system and are required in paper tape 
input. 

Code input to the computer for later translation 
into executable machine language instructions 
(object code). 

The process of removing one job from central 
memory and replacing it with another job. 

A file that can be accessed only by a system 
program. 

System programs used to perform system functions. 

The amount of CPU time a job is allowed to use 
before the system lowers its priority to allow 
other jobs to execute. 

Teletypewriter. 

File containing validation information for all users 
(user numbers, passwords, resources allowed, etc.) 

Any file assigned to a user while he is logged in 
at a terminal. 
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KRONOS TERMINAL ERROR MESSAGES 



The following error messages may appear at the terminal. 



Message 
APPEND ERROR. 
BUFFER ARC ERROR. 

CATALOG OVERFLOW - FILES. 

CATALOG OVERFLOW - SIZE. 

CHARGE FILE BUSY. 

CHARGE ILLEGAL AT THIS HOUR, 
CHARGE REQUIRED. 

COMMAND NOT UNIQUE. 
DEVICE UNAVAILABLE. 

DIRECT ACCESS DEVICE ERROR. 

EMPTY CATALOG. 

ERROR IN xxxxxx ARGUMENTS. 



ERROR IN FILE TYPE. 

ERROR IN MODE. 
ERROR IN PFILE ARGUMENTS. 
EXECUTE ONLY FILE. 
FILE NAME ERROR. 

FILE NAME MISSING. 
FILE NOT SORTED. 

FILE TOO LONG. 



Description 

An error was encountered when appending a file. 

Address of information for permanent file manager 
was in error. 

User has exceeded the number of permanent files 
he is allowed. 

User has exceeded the mass storage area allowed 
for indirect access permanent files. 

File is not available for charge purposes; wait 
and try again. 

Project number used is not valid at this time of day. 

Charge number and project number required in order 
to complete log-in sequence. 

The characters supplied are not unique to one com- 
mand. 

User is attempting to access files on a device not 
available for access. 

User is attempting to DEFINE or ATTACH direct 
access permanent files on a device not available 
for access. 

No files exist for the options specified in a CATLIST 
command. 

The command string given contained a syntax error, 
xxxxxx is the name of the system program issuing 
the diagnostic. This is similar to ILLEGAL PARA- 
METER. 

File type specified was not recognized (for example, 
CT=SEMI instead of CT = SPRIV). 

Mode specified was not recognized. 

An argument for permanent file request was illegal. 

The user has only an E permission level on the file. 

The file name must contain only alphanumeric char- 
acters. 

A file name must be specified before a listing con- 
taining the permit information can be obtained with 
a CATLIST command. 

Primary file has one or more lines with nonnumerici 
line numbers. (Use SORT, lfn command to obtain 
more detailed diagnostics. ) 

Limit for length of indirect access permanent file 
has been exceeded. a-1 



FILE TOO LONG TO SORT. 

FL TOO SHORT FOR PROGRAM, 
ILLEGAL CHARGE. 

ILLEGAL COMMAND. 

TT T T7>i rt ' AT T TPm y\ r*m-rj-\ -*t 

njijiLuiiij XjJLO 1 iu t~ IHJJLN. 

ILLEGAL LOGIN. 
ILLEGAL PARAMETER. 



ILLEGAL USER ACCESS. 



ILLEGAL WRITE ON APPEND 
ONLY FILE. 

ILLEGAL WRITE ON MODIFY 
ONLY FILE. 

ILLEGAL WRITE ON READ ONLY 
FILE. 

lfn EMPTY. 

lfn NOT ON MASS STORAGE. 

NO CONNECT TIME AVAILABLE. 

NO CPU TIME AVAILABLE. 

NO PRIMARY FILE. 

pfn ALREADY PERMANENT, 
pfn BUSY. 



pfn NOT FOUND. 



PERMISSION NOT GRANTED. 



Primary file is too long to be sorted automatically 
by the system. (Enter SORT, lfn command to obtain 
more detailed diagnostics. ) 

Self explanatory; increase field length with RUN 
command (or RFL card in BATCH subsystem). 

Either charge or project number does not exist or 
the project number entered is not available to this 
user number. 

The command name entered is not a valid command. 

The list option specified in a CATLIST command is 
illegal. 

The validation (VALIDUX) file for the permanent file 
family specified is not present in this system. 

May indicate: 

• Parameter is outside legal bounds. 

• Parameter is not one of the acceptable 
sets for the command. 

• Parameter referenced does not exist. 

User has either attempted an operation that he has 
not been validated to perform or has exceeded his 
validation limits (refer to the LIMITS command in 
section 4). 

User has attempted to write on a permanent file 
with append-only permission to the file. 

User has attempted to write on a direct access file 
with modify-only permission to the file. 

User has attempted to write on a permanent file with 
read-only permission to the file. 

File contains no data. 

The user has attempted to save a file that does not 
reside on mass storage. 

Terminal connect time allowed under this project 
number has been expended. 

Central processor time allowed under this project 
number has been expended. 

The user has attempted an operation which requires 
a primary file when there was none defined. 

The specified file already exists (use REPLACE). 

The file to be attached is currently assigned to 
another user in conflicting mode. 

The permanent file specified does not exist. If this 
message occurs in response to the CATLIST command, 
pfn may specify a user number. 

The user does not have WRITE or APPEND per- 
mission on the specified permanent file. 
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PF UTILITY ACTIVE, 

PFM ILLEGAL REQUEST. 
RESERVED FILE NAME. 
TOO MANY PARAMETERS. 



Permanent file utility operation is currently taking 
place. Permanent file commands (OLD, LIB, GET, 
etc. ) are aborted. Control card images entered in 
the BATCH subsystem are placed on recall until 
the utility operation is complete. 

An illegal request was issued to the permanent file 
manager. 

File name is reserved by the system (for the user's 
protection). 

The user has submitted more parameters than the 
command allows. 



ERROR MESSAGE FOR SYSTEM MALFUNCTIONS 

The following messages indicate system error conditions: 



( 



Message 
DATA BASE ERROR. 

ROLLIN FILE BAD. 



SYSTEM ERROR. 



Description 

An error in the structure of the validation file 
has been detected. Report this error to the com- 
puter center immediately. 

If this message is received, the user should log- 
off immediately. If he desires to continue, he may 
log-in again. The user should report this mal- 
function to the computer center and supply all 
terminal output since log-in, if possible. 

This error message should never appear. If it 
does, the user should report the malfunction to 
the computer center and supply all terminal output 
since log-in, if possible. 
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DIAL-IN PROCEDURE AND CHARACTER SET B 



This appendix presents an explanation of how to connect an interactive terminal to the 
KRONOS Time-Sharing System. Also included are illustrations of typical keyboard 
configurations for terminals using either standard or APL print, the function of certain 
control keys when connected to KRONOS, and finally, a list of the KRONOS character 
set. 

The procedure to connect the terminal to the system depends upon whether a data set or 
an acoustic coupler is being used to establish the connection. Both procedures are in- 
cluded in this appendix. Note that some terminals (most teletypewriter models) can 
include a data set or an acoustic coupler as an integral part of the terminal. 

It is recommended that the user read the instruction manual, generally supplied with the 
terminal, to become familiar with the operation of the terminal before connecting to 
KRONOS (that is, how to apply power, load paper, etc.). 

CONNECTING TERMINAL USING A DATA SET 

If the data set is included as part of the terminal, proceed as follows: 

1. Apply power to the terminal (refer to appropriate instruction manual). A 
dial tone should be audible when power is applied. 

2. Dial the correct phone number. A short high pitched signal indicates that 
the call has been answered. 

If the data set is a stand-alone unit, proceed as follows: 

1. Apply power to the terminal (refer to appropriate instruction manual). 

2. Remove the data phone receiver from its cradle. 

3. Press the TALK key on the data set to obtain a dial tone. 

4. Dial the correct phone number. A constant high pitched signal indicates 
that the call has been answered. 

5. Press the DATA key on the data set (indicator in key should light), and 
replace the receiver in its cradle. 

CONNECTING TERMINAL USING AN ACOUSTIC COUPLER 

1. Apply power to the terminal (refer to appropriate instruction manual). 

2. Turn on the acoustic coupler (not required if the coupler is included as 
part of the terminal). 

3. Using a standard telephone, obtain a dial tone and dial the correct phone 
number. A constant high pitched signal indicates that the call has been 
answered. 

4. Place the receiver in the acoustic coupler. 
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Figure B-l illustrates a typical terminal keyboard with standard print. 
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Figure B-l. Teletype Model 33 Keyboard 
Figure B-2 illustrates a typical terminal keyboard with APL print. 
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Figure B-2. Novar 5-41 Keyboard (APL Language) 
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IBM 2741 COMMUNICATIONS TERMINAL 



General Description 



CYBERNET Time-Sharing Service supports the IBM 2741 communications terminal, or any 
other fully compatible terminal, operating at 14.8 characters per second (=134.5 bps). The 
support of this terminal is limited to keyboard input and character printer output. Paper tape, 
card, and cassette tape readers, available as options on some 2741 compatible terminals, are 
not supported. Furthermore, support is limited to 2741 terminals operating in correspondence 
code. (BCD 2741 terminals are not supported. ) The keyboard/print element combinations 
supported are Manifold 72 and APL. Other keyboard/print element combinations will not 
necessarily translate into the corresponding internal representations. Figures B-3 and B-4 
show the supported keyboards. 



Specifications 

When ordering terminals, specify 2741 plant stock configuration D. 

• 3255 dial-up 

• 4708 interrupt 

• 9104 character spacing (10/inch) 

• 9114 data set attachment (WE103A) 

• 9435 line feeding (6 lines/inch) 

• 3811 115 VAC1 phase 60 CYC non-lock plug 

• 530006 RPQ print element and key tops (Manifold 72) 

or 

M40174 RPQ print element and key tops (APL) 

Type elements are: 

Correspondence (Manifold 72) 1167087 
APL 1167987 
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Figure B-3. IBM 2741 Correspondence (Manifold 72) Keyboard 
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Figure B-4. IBM 2741 APL Keyboard 



Table B-l illustrates the function of certain terminal control keys when connected to the KHONOS 
Time-Sharing System. 
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CENTRAL MEMORY CHARACTER EQUIVALENTS 

The manner in which characters entered from the terminal are interpreted by the system 
depends upon whether the user has specified that the characters belong to the full ASCII set 
(refer to the description of the ASCII command in section 4). For example, if the user 
enters the following characters to be mapped into the full ASCII set (128 characters recognized): 

aAbBcCdDeE 
the central memory equivalent (in. display code) is as follows: 

— Bit position (60-bit 
central memory word) 



However, if the characters are mapped into the subset of the ASCII character set used 
during NORMAL operation (61 characters recognized), the central memory equivalent 
(in display code) is as follows: 



59 




47 




35 




23 




11 





76 


01 


01 


76 


02 


02 


76 


03 


03 


76 


04 


04 


76 


05 


05 


55 


00 


00 


00 


00 



59 47 35 

| 01 01 1 02 02" 



23 



11 



I 03 03 | 04 04 | 05 05 | 



Characters entered under control of the BINARY command are not translated into dis- 
play code. It makes no difference if the ASCII command is in effect (128 characters 
recognized) or the characters are entered during NORMAL operation (61 characters 
recognized). However, each 8-bit character is weighted by a value of 4000B. For 
example, if the user enters the following characters and the BINARY command is in 
effect : 

aAbBcCdDeE 

the central memory equivalent is as follows: 



I 



59 



47 



35 



23 



11 



4 3 4 1 



4 3 3 



4 10 1 



4 3 4 4 



4 3 4 2 



4 10 4 



4 10 2 



4 14 5 14 3 5 



4 14 3 



The characters illustrated are entered from an ASCII code terminal although a 
correspondence code terminal may also be used. 

Table B-2 lists the KRONOS characters sets, indexed by 6000 internal display code. 
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Table B-2. KRONOS Character Sets - Terminal/Internal Display 





ASCII CODE TERMINAL f 


CORRESPONDENCE CODE TERMINAL TT 


6000 
INTERNAL j 
DISPLAY CODE 




STANDARD PRINT 


APL PRINT 


STANDARD PRINT 


APL PRINT 






CODE 




CODE 




CODE 


CHAR. 


CODE 




CHAR. 


(8-BIT OCTAL) 


CHAR. 


(8-BIT OCTAL) 


CHAR. 


(7-Brr OCTAL) 


(7-BIT OCTAL) 


(6/12-BIT OCTAL) 




NULL 




NULL 




NULL 





NULL 





00 




A 


101 


A 


341 


A 


071 


A 


171 


01 




B 


102 


B 


342 


B 


66 


B 


166 


02 




c 


303 


C 


143 


C 


072 


C 


172 


03 




D 


104 


D 


344 


D 


052 


D 


052 


04 


V. 


305 


E 


145 


E 


12 


E 


112 


05 




F 


306 


F 


146 


F 


063 


F 


163 


06 




G 


107 


G 


347 


G 


43 


G 


043 


07 




H 


110 


H 


350 


H 


46 


H 


046 


10 




I 


311 


I 


151 


I 


31 


I 


031 


11 




J 


312 


J 


152 


J 


003 


J 


103 


12 




K 


113 


K 


353 


K 


32 


K 


032 


13 




L 


314 


L 


154 


L 


06 


L 


106 


14 




M 


115 


M 


355 


M 


41 


M 


141 


15 




N 


116 


N 


356 


N 


22 


N 


122 


16 




O 


317 


O 


157 


O 


05 


O 


105 


17 




P 


120 


P 


360 


P 


013 


P 


013 


20 




Q 

R 


321 


<l 


161 


Q 


33 


Q 


133 


21 




322 


R 


162 


R 


51 


R 


051 


22 




s 


123 


S 


363 


S 


045 


S 


045 


23 




T 


324 


T 


164 


T 


02 


T 


002 


24 




U 


125 


U 


365 


U 


62 


U 


062 


25 




V 


126 


V 


366 


V 


061 


V 


061 


26 




W 


327 


w 


167 


w 


65 


w 


165 


27 




X 


330 


X 


170 


X 


042 


X 


142 


30 




Y 


131 


Y 


371 


Y 


47 


Y 


147 


31 




Z 


132 


Z 


372 


Z 


024 


Z 


124 


32 



















144 


33 







060 





060 


u 


V*±*± 






1 


261 


1 


261 


1 


040 


1 


040 


34 




2 


262 


2 


262 


2 


020 


2 


020 


35 




3 


063 


3 


063 


3 


060 


3 


160 


36 




4 


264 


4 


264 


4 


004 


4 


004 


37 




5 


065 


5 


065 


5 


010 


5 


010 


40 




6 


066 


6 


066 


6 


030 


6 


130 


41 




7 


267 


7 


267 


7 


050 


7 


150 


42 




8 


270 


8 


270 


8 


070 


8 


070 


43 




9 


071 


9 


071 


9 


064 


9 


064 


44 




+ 


053 


+ 


055 


+ 


067 


+ 


067 


45 




_ 


055 


- 


275 


- 


167 


- 


067 


46 




* 


252 


* 


120 


* 


023 


* 


013 


47 




/ 


257 


/ 


257 


/ 


123 


/ 


007 


50 




( 


050 


( 


053 


( 


53 


( 


153 


51 




) 


251 


) 


252 


) 


11 


) 


111 


52 




$ 


044 


$ 


176 


$ 


152 


a 


171 


53 






275 




245 




01 


= 


010 


54 


Key 





















fThe octal codes listed for ASCII code terminals are shown with even parity (normal). 
ft The octal codes listed for correspondence code terminals with APL print are shown with odd parity 
(normal). 

* Output only. 

f On TTY models having no underline, the BACKARROW key («-) takes its place. 

Correspondence standard print code listed- is -6-bit- code, without parity, plus UC/LC indicator - 1XX if 
upper case, 0XX is lower case, XX if either upper or lower case. Actual 7-bit 2741 code is odd parity. 

The user must enter ASCII mode in order to input all characters in this table with display code > 77. 
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Table B-2. KRONOS Character Sets - Terminal/Internal Display (Cont'd) 



ASCII CODE TERMINAL* 


CORRESPONDENCE CODE TERMINAL tt 


6000 

INTERNAL 

DISPLAY CODE 

(6/12-BIT OCTAL) 


STANDARD PRINT 


APL PRINT 


STANDARD PRINT 


APL PRINT 


CHAR. 


CODE 
(8-BIT OCTAL) 


CHAR. 


CODE 
(8-BIT OCTAL) 


CHAR. 


CODE 
(7-BIT OCTAL) 


CHAR. 


CODE 
(7-BIT OCTAL) 


(SPACE) 


240 


«3PACE) 


240 


(SPACE) 


00 


(SPACE) 


100 


55 


, 


254 


, 


254 


1 


073 


, 


073 


56 




056 


. 


056 


. 


021 




121 


57 


» 


G*±a 


,. 


nAt 

VTtX 




120 


,. 


040 


60 


c 


333 


1 


273 


< 


104 


c 


153 


61 


2 


335 


1 


072 


> 


130 


3 


111 


62 


: 


072 




276 


: 


121 




121 


63 


» 


047 


1 


113 


i 


140 


T 


032 


64 


& 


246 


X 


134 


& 


144 


X 


023 


65 


CR 


215 


CR 


215 


CR* 




NULL 





66 


LF 


012 


LF 


012 


LF 


56 


LF 


156 


67 


t 


336 


- 


042 


t 


113 


- 


020 


70 


# 


243 


« 


336 


# 


145 


!« 


070 


71 


< 


074 


< 


243 


< 


160 


< 


160 


72 


> 


276 


> 


047 


> 


150 


> 


150 


73 


(ESC 1) 





NULL 





NULL 





NULL 





74 


? 


077 


? 


321 


? 


161 


? 


133 


75 


(ESC 2) 





NULL 





NULL 





NULL 





76 


; 


273 


J 


074 


> 


173 


; 


073 


77 


NULL 





NULL 





NULL 





NULL 





7600 


a 


341 


a 


101 


A* 


071 


a 


171 


7601 


b 


342 


J. 


102 


B* 


66 


A. 


166 


7602 


c 


143 


n 


303 


C* 


072 


n 


172 


7603 


d 


344 


L 


104 


D* 


052 


L 


052 


7604 


e 


145 


C 


305 


E* 


12 


t 


112 


7605 


f 


146 


A 


137 


F* 


063 


- 


163 


7606 


g 


347 


7 


107 


G* 


43 


V 


043 


7607 


h 


350 


£ 


110 


H* 


46 


& 


046 


7610 


1 


151 


\ 


311 


I* 


31 


X 


031 


7611 


J 


152 





312 


J* 


003 





103 


7612 


k 


353 


•«— 


100 


K* 


32 


< 


004 


7613 


1 


154 


O 


314 


L* 


06 


o 


106 


7614 


m 


355 


-* 


134 


M* 


41 


r 


141 


7615 


n 


356 


T 


116 


N* 


22 


T 


122 


7616 


o 


157 





317 


O* 


05 


O 


105 


7617 


P 


360 


< 


044 


P* 


013 


> 


130 


7620 


q 


161 


> 


246 


Q* 


33 


? 


133 


7621 


r 


162 


p 


322 


R* 


51 


P 


051 


7622 


s 


363 


r 


123 


S* 


045 


r 


045 


7623 


t 


164 


* 


050 


T* 


02 


~ 


002 


7624 


u 


365 


+ 


125 


U* 


62 


4 


062 


7625 


V 


366 


u 


126 


V* 


061 


u 


061 


7626 


w 


167 


b) 


327 


w* 


65 


w 


165 


7627 


X 


170 


D 


330 


X* 


042 


D 


142 


7630 


y 


371 


t 


131 


Y* 


47 


t 


147 


7631 



Key 



f The octal codes listed for ASCII code terminals are shown with even parity (normal), 
ff The octal codes listed for correspondence code terminals with APL print are shown with odd parity 
(normal). 

♦Output only. 

t On TTY models having no underline, the BACKARROW key {<-) takes its place. 



Correspondence standard print code listed is 6-bit code, without parity, plus UC/LC indicator - 1XX if 
upper case, OXX is lower case, XX if either upper or lower case. Actual 7-bit 2741 code is odd parity. 

The user must enter ASCII mode in order to input all characters in this table with display code > 77. 
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Table B-2. 


KRONOS Character 


- Sets 


- Terminal/ 1 


nternai 


Display (uoi 


iv u; 


ASCH CODE TERMINAL* 


CORRESPONDENCE CODE TERMINAL 1 '* 


6000 


STANDARD PRINT 


APL PRINT 


STANDARD PRINT 


APL PRINT 


INTERNAL 
DISPLAY CODE 




CODE 




CODE 




CODE 




CODE 


CHAR. 


(8 -BIT OCTAL) 


CHAR. 


(8-Brr OCTAL) 


CHAR. 


(8 -BIT OCTAL) 


CHAR. 


(8-BIT OCTAL) 


(6/12-BIT OCTAL) 


Z 


372 


c 


132 


Z 


024 


c 


124 


7632 


DLE 


220 


DLE 


220 


NULL 





NULL 





7633 


BELL 


207 


BELL 


207 


NULL 





NULL 





7634 


DC2 


022 


DC2 


022 


NULL 





NULL 





7635 


ETX 


003 


ETX 


003 


NULL 





NULL 





7636 


DC4 


024 


DC4 


024 


NULL 





NULL 





7637 


NAK 


225 


NAK 


225 


NULL 





NULL 





7640 


SYN 


226 


SYN 


226 


NULL 





NULL 





7641 


ETB 


027 


ETB 


027 


NULL 





NULL 





7642 


CAN 


030 


CAN 


030 


NULL 





NULL 





7643 


EM 


231 


EM 


231 


NULL 





NULL 





7644 


VT 


213 


VT 


213 


NULL 





NULL 





7645 


SOH 


201 


SOH 


201 


NULL 





NULL 





7646 


i 


041 


V 


251 


T 


142 


NULL 





7647 


SI 


017 


SI 


017 


NULL 





NULL 





7650 


BS 


210 


BS 


210 


BS 


35 


BS 


135 


7651 


HT 


011 


HT 


011 


HT 


57 


HT 


057 


7652 


EOT 


204 


EOT 


204 


NULL 





NULL 





7653 


GS 


035 


GS 


035 


NULL 





NULL 





7654 


NUL 


000 


NUL 


000 


NULL 


75 


NUL 


075 


7655 


FF 


014 


FF 


014 


NULL 





NULL 





7656 


SO 


216 


SO 


216 


NULL 





NULL 





7657 


STX 


202 


STX 


202 


NULL 





NULL 





7660 


j 


173 


{ 


140 


I 


170 


«— 


001 


7661 


[ 


175 


[ 


374 


^ 


110 


—*■ 


001 


7662 


SUB 


232 


SUB 


232 


NULL 





NULL 


— 


7663 


ACK 


006 


ACK 


006 


NULL 





NULL 


— 


7664 


6* 


246 


NULL 





&* 


144 


NULL 


— 


7665 


\ 


134 


\ 


077 


V 


172 


\ 


007 


7666 




174 


1 


115 


1 


164 


1 


141 


7667 





176 




324 


NULL 





~ 


002 


7670 


# 


243 


NULL 


___ 


#* 


145 


NULL 





7671 


FS 


234 


FS 


234 


NULL 





NULL 





7672 


RS 


036 


RS 


036 


NULL 





NULL 





7673 


DEL 


377 


DEL 


377 


NULL 





NULL 





7674 


US 


237 


US 


237 


NULL 





NULL 





7675 


NL 





NL 





NL* 




NL 


155 


7676 


ESC 


033 


ESC 


033 


NULL 





NULL 





7677 


NULL 





NULL 





NULL 





NULL 





7400 


@ 


300 


= 


175 


@ 


171 


A 


144 


7401 


% 


245 


+ 


173 


% 


124 


+ 


023 


7402 


\ 


140 


m 


335 


o 


103 


V 


064 


7403 


_ 


137+ 




306 


— 


163 


NULL 





7404 


X-ON 


021 


X-ON 


021 


NULL 





NULL 





7405 


X-OFF 


223 


X-OFF 


223 


NULL 





NULL 





7406 


ENQ 


005 


ENQ 


005 


NULL 





NULL 





7407 



Key 



t The octal codes listed for ASCII code terminals are shown with even parity (normal). 

ff The octal codes listed for correspondence code terminals with APL print are shown with odd parity 

(normal) . 
^Output only. 
f On TTY models having no underline, the BACKARROW key (■*-) takes its place. 

"CoTTesporideTice standard print code" listed is ©-bit code, without parity, pfrts-iJe/LC indicator » 1XX if 
upper case, 0XX is lower case, XX if either upper or lower case. Actual 7-bit 2741 code is odd parity. 

The user must enter ASCII mode in order to input all characters in this table with display code > 77. 
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PAPER TAPE OPERATIONS 



Paper tape is used for preparing input off-line (when time is not charged) and entering 
it on-line (when time is charged). This ensures accuracy and speed when most needed. 
An input tape can include programs, data, and commands. Accordingly, it is possible 
for the entire terminal operation, after log-in, to be run from paper tape. 

This exposition assumes a typical teletypewriter (model 33) with a paper tape punch 
and a paper tape reader. 

The paper tape punch has four buttons with the following labels and use. 

ON Turns the punch on 

OFF Turns the punch off 

REL. Releases the feedwheel so one can freely move the tape through 

the punch head 

B.SP. Backspaces the tape one row of holes each time it is pressed. 

This is used to make corrections when preparing a tape off-line 
(refer to detailed description later in this appendix). 



The paper tape reader has one switch with four positions, 
as follows: 



Their labels and use are 



START Momentarily pressing the switch to this uppermost position starts 

the reader." The switch snaps back to the AUTO position and 
reading continues. 

STOP Reading stops immediately whenever the switch is moved to this 

position. 

AUTO This position is used in conjunction with the input and processing 

of commands and data in tape mode (tape mode is explained later 
in this appendix). It allows the tape reader to be turned off and 
on so that processing of each command or line of data can be 
completed before additional input is entered. 

FREE Releases the feedwheel so one can freely slide the tape in and 

out of the read head. 

NOTE 

On teletypewriters lacking an AUTO 
position, reading must be manually 
restarted each time it has been stopped. 



CONTROL CHARACTERS 

Each line of input from paper tape must end with a particular sequence of control 
characters. These are punched by functional keys on the teletypewriter keyboard. 
The control characters used with paper tape are as follows. 



GR 



Carriage return. This is the, JRETURN key on the keyboard. It 
moves the print head back to the beginning of the line and informs 
the system that this line of input is completed. 



C-l 



LF 



CTRL/ 
X-OFF 

RO(n) 



NUL 



Line feed. This is the LINE FEED key on the keyboard It 
advances he paper roller one line. In normal mode, the system 
sends back a signal that initiates this feed; in tape mode, this 
signal is not sent and is therefore required on tape. 

X-OFF. The appearance of this character on the tape durine 
reading turns the tape reader off. This character is punched by 
holding down the CTRL key and pressing the X-OFF key 

Rubout. This is the RUB OUT key on the keyboard. It punches 
a full row of holes. This row is interpreted as null by the system 
and hence this character is used for spacing and overpunching 
errors. The n parameter specifies the minimum number of times 
this character should be punched in sequence. 

Null. This is the ASCII character represented by a feed hole only 
(blank tape). It may be used as a fill character. 
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INPUT LINES 

The following line formats are used to enter programs, data, and commands. The 
left half of the page shows an example of the input and the right half shows the con- 
trol characters that immediately follow the last input character. It should be noted 
that each line is terminated with three rubouts to provide separation from the next 
line. While it is possible that adequate separation may be provided with less than 
three rubouts, this is the recommended number. (The system punches three rubouts 
at the end of each line when a tape is produced on-line. ) 



PROGRAM LINE 

100 PROGRAM TEST (INPUT, OUTPUT) 



- CR LF RO(3) 



DATA LINE 

? 12.44,18.31,29.08 



CR LF CTRL/X-OFF RO(3) 



The ? is supplied by the system, The remainder of the line comes from the tape 
The X-OFF turns the reader off to allow this data to be processed before the next' 
line is read. 



COMMAND LINE 

CATLIST/LO=F - 



- CR LF CTRL/X-OFF RO(3) 



The X-OFF turns the reader off to allow processing of the command to be completed 
before the next line is read. 

PUNCHING A PAPER TAPE OFF-LINE 

The following procedure is used to punch a tape when the teletypewriter terminal is 
not logged-in. * 

U kT 11 ^u tel u etv P ewriter on ^ local mode by pressing the LCL button 
below the phone dial. 

2. Turn the paper tape punch on by pressing the ON button located n n the 
punch. 
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3 P^epar-e a tape leader of about 30 rubouts (3 inches) by pressing the RUB OUT 1 
and repeat (REPT) keys togehter, or by punching blank tape if the terminal I 
has the capability. 1 

4 With a pencil, trace the arrow above the punch output onto the tape. This 
will identify the start of the tape for reading. (It is possible to put the tape 
in the reader backwards. ) 

5. Type in the input lines with their appropriate control characters. 

6. Add a 3-inch trailer of rubouts or blank tape and tear the tape off. | 

- ■*- „ .v, /-IT TJ l-.-n. l~„1„,r, +V.o nVinno Hi a 1 tl-» tllTTl tb** frf»1 PtVpewH teF Off. 

TAPE MODE 

To read and process data and commands from tape, it is necessary that the tape 
reader be turned off and on to allow time for processing. By entering tape mode, 
the user enables the system to synchronize tape input with its processing. This mode 
also inhibits the output of header messages and the READY message when LIST 
(or LNH) is used to punch a tape on-line (refer to Punching a Tape On-line). It 
should be noted that carriage return (CR) entered on an empty input line will be 
ignored by the system while in tape mode. 

The user enters tape mode by typing the TAPE command and pressing the carriage 
return key. The system acknowledges entry into this mode by advancing the printout 
paper one line. It will not print READY. If the reader switch has been in the AUTO 
position, reading begins automatically; if the reader switch was in the OFF position, 
reading does not begin until manually initiated by momentarily moving the switch to 

I START. All subsequent commands and data entries are acknowledged by the one-line 

* advancement without the printout of READY. 

The user exits from tape mode by typing the NORMAL command and pressing the 
carriage return key. 

PUNCHING A TAPE ON-LINE 

To punch a tape with information already contained in a system file, the following 
procedure is followed. 

1. If not logged-in, log-in. 

2. If not in tape mode, type TAPE and press the carriage return key. 

3. Turn the punch on. 

4. Run a leader of rubouts or blank tape. 

5. Type in LIST if the primary file is to be punched; type in LIST,F=lfn if a 
working file other than the primary file is to be punched. (The short form 
LNH is permissible. ) 

6. Press the carriage return key. The file will be listed and punched 
simultaneously. The system will add the appropriate control characters 
at the end of each line. 

7. Run a trailer of rubouts or blank tape. 
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CORRECTIONS 

While punching a tape off-line, corrections can be made by backspacing over the in- 
correct punch (use the B.SP. button on the punch) and punching a rubout over the 
error (use the RUB OUT key on the keyboard). Then punch in the correct character. 

It is also possible to make corrections by using the back arrow as in normal, on-line 
operation. However, the error and arrow will appear in the printout. Likewise, when 
line numbers are being used, an erroneous line can be retyped (and repunched) with the 
same line number. A^ain the erroneous and correct version will a^^ear in printout 
although the system will recognize only the correct version during processing. 



Example: 

In this example, the input tape contains only program lines, 
typed in by the user before and after the tape is read in. 



Commands and input are 



The tape as punched is shown below. The left half of the page gives the printed copy 
which was produced as the tape was punched; the right half of the page shows the 
control characters which were entered at the end of each line but were not printed. 
In this example, any character shown as RO (rub-out) may be replaced by NUL (blank 
tape). 

100 LET FACTOR=l 

110 INPUT N 

120 FOR 1 = 1 TO N 

130 LET FACTOR=FACTOR*I 

140 PRINT FACTOR 

150 NEXT I 

160 END 

To demonstrate the use of this tape, it is assumed the user is logged-in under the 
NULL subsystem. He positions this tape in the reader and sets the reader switch 
to AUTO. The following is the printout that results from the interaction of user and 
tape with the terminal. The right half of the page contains explanations of the action. 



RO(30) or 


NUL(30) 


CR 


LF 


RO(3) 


CR 


LF 


RO(3) 


CR 


LF 


RO(3) 


CR 


LF 


RO(3) 


CR 


LF 


RO(3) 


CR 


LF 


RO(3) 


CR 


LF 


RO(30) 



BASIC 

READY. 

NEW, FACT 1 
READY. 



TAPE 



100 LET FACTOR = l 

110 INPUT N 

120 FOR 1=1 TO N 

130 LET FACTOR=FACTOR*I 

140 PRINT FACTOR 

150 NEXT I 

160 END 

RNH 



ILLEGAL STATEMENT AT 100 
ILLEGAL STATEMENT AT 130 
ILLEGAL STATEMENT AT 140 



By typing in this command, the user 
enters the BASIC subsystem. 

This line is typed in to establish a 
new primary file with the name FACT1 

The command TAPE is typed in, and as 
soon as the carriage return takes effect, 
the tape reader goes on and the entire 
tape (seven lines) is read in. 
The reader runs through the trailer of 
rubouts and then turns itself off. 



Types in RNH and receives the diagnostics 
shown. BASIC variables cannot be more 
than two characters. 
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SS 0.015 SECS. 

RUN COMPLETE. 

100 LET F = l 
130 LET F=F*I 
140 PRINT F 

RNH , 



? 5 
1 

e\ 

6 

24 
120 



Types in the corrective coding shown. 

Initiates another run. 

The system replies with ? 

He types in 5 and receives the 

desired printout. 



SS 



0.017 SECS. 



RUN COMPLETE. 



LIST 

100 LET F = l 

110 INPUT N 

120 FOR 1=1 TO N 

130 LET F=F*I 

140 PRINT F 

150 NEXT I 

160 END 



Example: 



The user wants to punch a new tape con- 
taining this corrected program. He types 
in LIST but does not press the carriage 
return key. He turns on the punch, runs 
off some leader, and then enters the 
carriage return. As the system prints the 
listing, it also punches a tape with the 
same information along with the control 
characters CR, LF, and RO(3) at the end 
of each line. After this, the user punches 
a trailer of rubouts and tears off the 
new tape. He discards the original tape. 



In this example, the input tape contains not only a program but commands to execute, 
list, modify, and save that program, as well as the input data used by that program. 

The complete tape as punched is shown below. The left half of the page gives the printed 
copy which was produced as the tape was punched; the right half of the page shows the con- 
trol characters which were entered at the end of each line but were not printed. In this 
example, any character shown as RO (rub-out) may be replaced by NUL (blank tape). 

FORTRAN 

NEW, DEMO 

100 PROGRAM DEMO(INPUT, OUTPUT) 

110 DIMENSION 11(5) 

120 READ 10, (II(J),J = 1,5) 

130 10 FORMAT(5I5) 

140 PRINT 20, (II(J), J = l,5) 

150 20 FORMAT(5I10) 

160 END 

RNH 

1111122222333334444455555 

SAVE, DEMO =TAPE1 

135 DO 1 1=1,5 

137 II(I)=II(I)+4444 

139 1 CONTINUE 

RESEQ, 10075 ~" 

LIST 

RNH 

1111122222333334444455555 

REPLACE, DEMO =TA PE 1 



RO(3 
CR 


U) or 
LF 


NUL(3U) 
CTRL/X-OFF 


RO(3) 


CR 


LF 


CTRL/X-OFF 


RO(3) 


CR 


LF 


RO(3) 




CR 


LF 


RO(3) 




CR 


LF 


RO(3) 




CR 


LF 


RO(3) 




CR 


LF 


RO(3) 




CR 


LF 


RO(3) 




CR 


LF 


RO(3) 




CR 


LF 


CTRL/X-OFF 


RO(3) 


CR 


LF 


CTRL/X-OFF 


RO(3) 


CR 


LF 


CTRL/X-OFF 


RO(3) 


CR 


LF 


RO(3) 




CR 


LF 


RO(3) 




CR 


LF 


RO(3) 




C"R 


LF 


CTRL/X-OFF 


RO(3) 


CR 


LF 


CTRL/X-OFF 


RO(3) 


CR 


LF 


CTRL/X-OFF 


RO(3) 


CR 


LF 


CTRL/X-OFF 


RO(3) 


CR 


LF 


CTRL/X-OFF 


RO(30) 
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To execute this tape, the user logs in, positions the tape in the reader, sets the reader switch to 
AUTO, types in TAPE, and starts the reading of tape by pressing the carriage return. Then, he 
observes the remainder of the action without intervention. 

The following is the printout of the execution of the tape. The right half of the page contains explana- 
tions of the action. 



< 



FORTRAN - 



NEW.DEMO-*- 



100 PROGRAM DEMO(INPUT, OUTPUT) 

110 DIMENSION n(5) 

120 READ 10,(n(J),J=l,5) 

130 10 FORMAT(5I5> 

140 PRINT 20,(n(J),J=l,5) 

150 20 FORMAT(5I10> 

160 END 

RN H - « — — 



? 1111122222333334444455555-*- 



When this line is read, the reader stops. As 
- soon as FORTRAN is established as the current 
subsystem, the system turns the reader back on. 

When this line is read, the reader stops. After a 
■new primary file called DEMO is established, the 
system turns the reader back on. 



The seven lines of the program are read in 
without interruption. 



-The command to run the program is read in and the 
reader turned off. 

-Processing reaches the READ statement (line 120) 
and the system prints ?. The system then turns 
the reader back on and the line of data is read in. 
Then the reader is turned off to allow data proces- 
sing. 
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11111 22222 33333 44444 
END. 

SS 0. 130 SECS. 

RUN COMPLETE. 



Resultant printout 

55555 



t 
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SAVE , DEMO=T APEl-«- 



This command is read in and the reader turned off. 
A copy of the program demo is made an indirect 
access permanent file with the name TAPE1, Then 
the reader is turned back on. 



135 DO 1 1=1,5 

II(I)=n(I)+4444 
139 1 CONTINUE 






ss 



LIST-«- 



0.019 SECS. 



00100 PROGRAM DEMO(TNPUT, OUTPUT) 

00105 DIMENSION II<5) 

00110 READ 10, (II(J),J=1,5) 

00115 10 FORMAT (515) 

00120 DO 1 1=1,5 

00125 II(I)=H(I)+4444 

00130 1 CONTINUE 

00135 PRINT 20, (II(J),J=1,5) 

00140 20 FORMAT (5110) 

00145 END 



RNH-*- 



? 1111122222333334444455555 



These three lines of modification are read in from 
the tape without interruption. 

JL UC J.%,j2A%JJ-JKX, »•*»■■■■■■ ™ ■ ■' ■ J.O A. VsCLU 111 LU1U VUV A VUuCl 



15555 



26666 



turned off. When resequencing is accomplished 
according to specifications, the reader is turned 
back on. 

This command is read from tape and the tape 
reader turned off. Then the system lists the pri- 
mary file which contains the above modifications 
and resequenced format. When the listing is com- 
pleted, the reader is turned on again. 



-This command is read in, the reader turned off, 
and the modified program executed. The system 
prints the ? and then turns the reader on. The 
line of data is read in from the tape and the reader 
turned off. The data is processed and results 
printed. 



37777 48888 59999 



END. 



SS 0. 141 SECS. 

RUN COMPLETE. 
REPLACE , DEMO=T APEf 



This last command is read in and the reader turned 
off. A copy of this revised version of DEMO re- 
places the old one that was made an indirect access 
permanent file under the name T APE1 . 



The reader is turned back on. It runs through the 
trailer of rubouts and then turns itself off. 

If, at this point, the user has no more tapes to run, 
he should exit tape mode by issuing the NORMAL 
command. 
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MASS STORAGE DEVICE STATISTICS 



Under CYBERNET KRONOS there is only one mass storage device type available. Therefore, per- 
manent file commands do not have a parameter for device type selection. However, when creating 
a direct access permanent file a user may specify a desired amount of space with the S parameter. 
(See chapter 5 under permanent file command format. ) 

The following list describes the mass storage device supported under CYBERNET KRONOS, and the 
block size allocated for direct access files. 

Block Size 
Device Code Device PRUs CM Words Characters 

Din 844 Disk Storage Sub- n*107 n*6848 n*68480 

system (1 < n < 8) 
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TEXT EDITOR COMMAND INDEX 



This is a list of the commands available under Text Editor, 
refer to the Text Editor (EDIT) Reference Manual. 



For additional information, 
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ADD(S) 
ADD(S);n 
ADD(S):/ string/ 
ADD(S):/string/;n 

ALIGN 

ALIGN;n 

ALIGN: /string/ 

ALIGN:/string/;n 

ALlGN:/stringl/, /string2/ 

ALIGN:/stringl/, /string2/;n 

BLANK(S) 

BLANK(S);n 

BLANK(S):/ string/ 

BLANK(S) :/ string/ ;n 

BLANK(S):/stringl/. /string2/ 

BLANK(S):/stringl/, /string2/;n 

CHANGE (S) 
CHANGE(S);n 
CHANGE(S):/ string/ 
CHANGE(S): / string/ ;n 
CHANGE (S):/stringl/, /string2/ 
CHANGE(S):/stringl/, /string2/;n 

CLEAR 



DEFTAB 
DEFTAB:/tabchar/ 

DELETE(S) 
DELETE(S);n 

DELETE(S):/ string/ 
DELETE(S):/ string/ ;n 
DELETE(S):/stringl/, /string2/ 
DELETE(S):/stringl/, /string2/;n 



END 

EXTRACTS) 
EXTRACT(S);n 
EXTRACT(S):/ string/ 
EXTRACT(S):/ string/ ;n 
EXTRACT(S):/stringl/, /string2/ 
EXTRACT(S):/stringl/, /string2/;n 



FIND(S) 

FIND(S);n 

FIND(S):/ string /;n 

FIND(S) : / string 1 / , / string2 / ;n 

INSERTS:/stringl/, /string2/;n 

LENGTH;n. 
LENGTH;* 

LINE 

LIST(S) 

LIST(S);n 

LIST(S):/ string/ 

LlST(S):/string/;n 

LIST(S):/stringl/, /string2/ 

LIST(S):/stringl/, /string2/;n 

LIS TAB 

MERGE: /lfn/;n 
MERGE:/lfn/, /string/ ;n 

NUMBER(S) 
NUMBER(S):/ string/ 
NUMBER(S):/stringl/, /string2/ 

REPLACES 
REPLACES: / string/ ;n 
REPLACES:/stringl/, /string2/;n 

RESET 

SET 

SET, n 

SET-n 

SET: /string/ 

SET:/ string/ ;n 

TAB 

TABr/tj, ...,t n / 

WIDTHjn (6 < n <_ 150> 
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Several file names are reserved for system use or have special significance to the 
system. These reserved names protect the user from accidentally destroying some 
of his own files. The message RESERVED FILE NAME, indicates that the user has 
attempted to use one of these file names. 

The reserved file names are: 

INPUT 

OUTPUT 

PUNCH 

PUNCHB 

P8 

SCR 

SCR1 

SCR2 

SCR3 

SCR4 

An attempt is not always made to prevent the use of these file names. Many of the 
6000 product set members, such as the COMPASS assembler, use other scratch files 
in addition to those listed. A user should consult the appropriate reference manuals 
for a complete list of these files. System integrity does not depend on preventing the 
use of these reserved file names. 
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SAMPLE SESSION AT THE TERMINAL 



This appendix presents a typical interaction of a beginning user with the KRONOS Time-Sharing System. 
After logging in, the user tries basic operations in the various subsystems and tests a cross section of 



The left half of the page is the terminal (Teletype model 33) printout of the interaction. The right half 
of the page gives explanations. In a few places the terminal printout has been vertically expanded to 
allow spacing for the inclusion of the relevant comments. 
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// 

NET nnnnnn 

PLEASE SIGN ON--KC 

yy/mm/dd. hh. mm. ss . 

EASTERN CYBERNET CENTER SN166 KRONOS 2 

USER NUMBER: USER123 

PASSWORD 



TERMINAL: 40.TTY 

RECOVER/SYSTEM: NULL 

OLD, NEW, OR LIB FILE: NEW, TEST 

READY. 

TEXT -4 ■ 

ENTER TEXT MODE 
LINE 1: ABCDEFGHU 
LINE 2: BCDEFGHUK 
LINE 3: CDEFGHIJKL 
LINE 4: DEFGHIJKLM 

LINE 5: EFGHIJKLMN 

LINE 6: FGHUKLMNO 

LINE 7: GHLJKLMNOP 

LINE 8: HIJKLMNOPQ 

LINE 9: IJKLMNOPQR 

LINE 10: JKLMNOPQRS 



The user intends to create a primary file that he 
will use for experimental purposes. He will pre- 
serve this file as an indirect access permanent file . 
However, he does not want a particular subsystem 
associated with the file. Accordingly, he enters 
the NULL subsystem. 

User enters text mode because the source data to be 
entered will not have line numbers. 



Types in an array of alphanumeric characters to be 
used in testing the Text Editor. 



EXIT TEXT MODE -4- 



-User exits text mode by pressing the BREAK key. 
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LIST.R 
LINE 1 


ABCDEFGHIJ 


LINE 2 


BCDEFGHIJK 


LINE 3 


CDEFGHIJKL 


LINE 4 


DEFGHIJKLM 


LINE 5 


EFGHIJKLMN 


LINE 6 


FGHIJKL--EOR-- 


MNO 




LINE 7 


GHIJKLMNOP 


LINE 8 
LINE 9 
LINE 1 
--EOR- 


HIJKLMNOPQ 
IJKLMNOPQR 
3: JKLMNOPQRS 


READY 




rVrt^J^ ' 




READY 

LNH.R. 
LINE 1- 




. ABCDEFGHIJ 


LINE 2: 


BCDEFGHIJK 


LINE 3- 


CDEFGHIJKL 


LINE 4: 


DEFGHIJKLM 


LINE 5: 


EFGHIJKLMN 


LINE 6 


FGHIJKLMNO 


LINE 7- 


GHIJKLMNOP 


LINE 8: 
LINE 9- 
LINE 1( 
--EOR- 


HIJKLMNOPQ 
IJKLMNOPQR 
): JKLMNOPQRS^ — 


READY. 





SAVE,TEST=TEXT1 
READY. 



Remembers that Text Editor can 
only operate on a single record. 
He suspects he has created more 
than one record and calls for a 
listing with end-of-record marks. 

His suspicions are confirmed. 



The PACK command compresses the 
file into one record. 

This is verified with another 
listing. 



EDIT 



In addition to using this file in 
the subsequent EDIT operations, the 
user feels he may need it for other 
testing and makes a permanent file 
(indirect access) called TEXT1. 
The original copy, called TEST, re- 
mains as the primary file. 

■Enters the Text Editor 
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BEGIN TEXT EDITING. 

? LIST - 



LINE 1: ABCDEFGHIJ 
? LIST;3 



■List the first line, 
at the first line. 



Pointer remains 



List the first three lines. 



LINE 1 
LINE 2 

LINE 3 
? LIST 

LINE 3: 



ABCDEFGHIJ 
BCDEFGHIJK 

CDEFGHIJKL 
/JKL/ - 



CDEFGHIJKL 



List the first line in which the 
phrase /JKL/ occurs 
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? LIST: /JKL /r3 - 



LINE 3 
LINE 4 
LINE 5 
? LIST 

LINE 3 
LINE 4 
? LIST 

LINE 3 
LINE 4 
LINE 5 
LINE 6 



CDEFGHIJKL 
DEFGHIJKLM 
EFGHIJKLMN 
/JKL/. /GHI/* 



CDEFGHIJKL 
DEFGHIJKLM 
/JKL/,/GHI/;3 — — 



CDEFGHIJKL 
DEFGHIJKLM 
EFGHIJKLMN 
FGHIJKLMNO 



? LISTS: /DEFG/ - 



DEFG 
? LISTS: /DEFG/ ;3 - 



DEFG 
DEFG 
DEFG 

? LISTS:/LMN/,/NOP/- 



LINE 6: 
LINE 7: 
? FIND;5 
LINE 6: 



LMN 
FGHIJKLMNO 
GHIJKLMNOP 



FGHIJKLMNO 



? FIND:/DEF/;3- 

PHRASE NOT FOUND. 



? RESET 



? FINDS: /DEF /;3- 
DEF 



? RESET — 



? ADD;2 - 



-List the first three lines in which 
the phrase /JKL/ occurs. 



• List the line(s) in which the string 
beginning the /JKL/ and ending with 
/GHI/ first occurs. 

-List the lines that contain the first 
three occurrences of the string beginning 
with /JKL/ and ending with /GHI/. 



List the first occurrence of the 
phrase /DEFG/. 

List the first three occurrences of 
the phrase /DEFG/. 



List the first occurrence of the 
string beginning with /LMN/ and 
ending with /NOP/'. 

Move the pointer five lines and list 
the new line. Pointer remains at new 
line. 

Move the pointer another three lines 
and list the first line in which the 
phrase /DEF/ occurs. Pointer has 
moved beyond the range of this phrase 
and hence it is not found. 

- Moves the pointer back to the 
beginning of the file. 

■ Moves the pointer three lines and lists 
the first occurrence of /DEF/. 

• Moves the pointer back to the first 
line. 



Calls for text to be added after the 
second line. 
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ENTER TEXT. 
? /FIRST INSERTION/ 

READY. 
? ADD;4 - 

ENTER TEXT. 
? /SECOND INSERTION/ 

READY. 
? ADD: /MNO/- 

ENTER TEXT. 
? /THIRD INSERTION/ 

READY. 
? ADDS: /MNO /- 

ENTER TEXT. 
? /FOURTH INSERTION/ 

READY. 

? SET;8 « 

? DELETE;2 

? RESET 

?LIST;* 

LINE 1: ABCDEFGHIJ 

LINE 2: BCDEFGHIJK 

FIRST INSERTION 

LINE 3: CDEFGHIJKL 

SECOND INSERTION 



Calls for text to be entered after 
the fourth line. 



■Calls for text to be entered after the 
first line in which /MNO/ occurs. 



-Calls for text to be entered immediately 
after the phrase /MNO/. 



LINE 


4: 


DEFGHIJKLM 


LINE 


5: 


EFGHIJKLMN 


LINE 


6: 


FGHIJKLMNOFOURTH 


LINE 


8: 


HIJKLMNOPQ 


LINE 


9: 


IJKLMNOPQR 


LINE 


10: 


JKLMNOPQRS 



-The pointer is moved down eight lines 
and then the next two lines are deleted. 
Taking into account the above insertions, 
it should stop at /THIRD INSERTION/ and 
then eliminate that line and the next 
one (line 7). 

The pointer is moved back to start and 
a listing made of the entire file. 



INSERTION 
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-END OF FILE- 
? OLD, TEXT 1 

OLD SYNTAX ERROR. 
? END 

END TEXT EDITING. 
READY. 

OLD, TEXT 1 
READY. 

EDIT 
BEGIN TEXT EDITING. 
? CHANGE;3 



ENTER TEXT. 
? /AAA 
? BBB 
? CCC/ 

READY. 
? CHANGE: /JKLM/- 

ENTER TEXT. 
? /OO 
? OO 
? OO/ 

READY. 



The user would like to get back the 
original format of this file. Since the 
original is an indirect access permanent 
file, he calls for a copy to be entered 
as the primary file (OLD). But commands 
cannot be entered from the Text Editor. 
Accordingly, he exits from EDIT, enters 
his OLD, and then reenters EDIT. 



-Change the first three lines to the 
text that follows. 



Change the first line with the phrase 
/JKLM/ to the text that follows. 
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? LIST;*-* 

AAA 

BBB 

CCC 

OO 

OO 

OO 

LINE 5: 

LINE 6: 

LINE 7; 

LINE 8: 

LINE 9: 

LINE 10: 



- A listing of the modified file verifies the changes. 



EFGBUKLMN 
FGHIJKLMNO 
GHIJKLMNOP 
HIJKLMNOPQ 
IJKLMNOPQR 
JKLMNOPQRS 
-END OF FILE- 

? END-* 

END TEXT EDITING. 
READY. 



Exists from the Text Editor. 



BASIC -* 

READY. 

NEW, DEMO 
READY. 



AUTO-* — 

00100 INPUT N 

00110 PRINT TAB(169)'TNTEGERS","SUM" 

00120 LET S=0 

00130 FOR 1=1 TO N 

00140 S=S+I 

00150 PRINT TAB(19);I,S 

00160 NEXT I 

00170 END 

00180 *DEL*-« 

NORMAL 
READY. 



— Enters the BASIC subsystem. 
Establishes new primary file. 



Enters AUTO mode so that the system will supply 
line numbers 



■ Deletes this line so he can type NORMAL and exit 
AUTO mode. 



90 REM SUMMATION OF THE FIRST N INTEGERS 

95 REM THE VALUE OF N TO BE USSP SUPPLIED AT EXECUTION 



RESEQ, 1000, 1000-*- 



- Resequences line numbering 
to begin at 1000 and increase 
in increments of 1000. 



Adds comments to 
beginning of pro- 
gram. 



SS 0.028 SECS. 

READY. 
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LIST A listing shows the new line numbers 

73/10/29. 10.46.27. 

PROGRAM DEMO 

01000 REM SUMMATION OF THE FIRST N INTEGERS 

02000 REM THE VALUE OF N TO BE SUPPLIED AT EXECTION 

03000 INPUT N 

04000 PRINT TAB(169)"INTEGERS", "SUM" 

ftCfiAd t vr a—n 

06000 FOR 1=1 TO N 

07000 S=S+I 

08000 PRINT TABa9);I,S 

09000 NEXT I 

10000 END 

READY. 

RNH 
ILLEGAL STATEMENT AT 4000-. Refers to typo error in line 04000. 

SS 0.017 SECS. 

RUN COMPLETE. 

04000 PRINT TAB(16);'1NTEGERS", "SUM" Corrected statement. i 

RNH 

? 10 Program is executed and the input for N is 10. 

The printout follows. 



INTEGERS 


SUM 


1 


1 


2 


3 


3 


6 


4 


10 


5 


15 


6 


21 


7 


28 


8 


36 


9 


45 


10 


55 



SS 0.037 SECS. 

RUN COMPLETE. 



I 
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SAVE, DEMODEMOl 
ILLEGAL PARAMETER. 



SAVE , DEM0=DEM01-«- 
READY. 



Decides to make this program an indirect access 
permanent file called DEMOl. The first attempt 
fails because of the space after the comma. Note 
DEMOl will have a BASIC subsystem flag associ- 
ated with it because that subsystem is in effect 
when the file is saved. Hereafter, when the file is 
accessed (using the OLD command), the BASIC 
subsystem will also be selected. 



1UUU itElVL SUJ.VlJYUil.HJlN KJ£ LtlEi KJUU UN 1 JHJ.Dj.iib 

2000 Alters the program to sum the odd integers 

6000 FOR 1=1 TO N STEP 2 
RESEQ, 1000, 1000 



SS 
READY. 



0.028 SECS. 



RNH 
? 8-«- 



INTEGERS SUM 



1 
3 

5 

7 



1 
4 
9 
16 



Enters the value 8 for N in the request for input. 



SS 



0.026 SECS. 



RUN COMPLETE. 



SAVE, DEMO=DEM02- 
READY. 



-Makes this altered program an indirect access 
permanent file which he calls DEM02. This file 
will also have a BASIC subsystem flag associated 
with it. 



NEW, TEST- 
READY. 



-Establishes a new primary file. 



BATCH-*- 



- Enters the BATCH subsystem. 



$RFL, 20000, 



• By default, the system supplies a field length of 
20000 octal words. 



/DEFINE, ALPHA - 



-Creates an empty direct access permanent file called 
ALPHA. 
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RECORD 2 



-lvjljv^jxvjl; 



/COPYCR (INPUT, ALPHA, 3) 

? FILE ALPHA - RECORD 

? 

? 

? 

? 

? 

? 

«? 

? 

? 

? 

COPY COMPLETE. 

/LIST,F=ALPHA 

COPY COMPLETE. 
/REWIND, ALPHA 

$REWIND, ALPHA. 
/LIST,F=ALPHA 



1 - LINE 1 
LINE 2 
LINE 3 



LINE 1 
LINE 2 



LINE 2 
LINE 3 



Calls for input to the permanent file 
in the form of three records 



This data is written directly on 
the direct access file without 
any local copy. 



Calls for a listing of this direct 

access file. 

Gets a null record because he has 

not rewound. 

He rewinds and lists successfully. 



FILE ALPHA - RECORD 1 


- LINE 1 




LINE 2 




LINE 3 


RECORD 2 


- LINE 1 




LINE 2 


RECORD 3 


- LINE 1 




LINE 2 




LINE 3 


COPY COMPLETE. 








READY. 




NEW, TEST « 





Enters the FORTRAN subsystem. 



Creates a program that generates 
tables of logarithms for various bases. 



100C PROGRAM TO CREATE A TABLE OF LOGARITHMS 

110CFOR ANY BASE FROM 0.1 TO 9.9 

120 PROGRAM TEST(INPUT, OUTPUT) 

130 READ, N, BASE 

140 DO 1 1=1, N 

150 READ, VALUE 

160 BLOG = ALOG10(VALUE)/ALOG10(BASE) 

170 PRINT 10, BASE, VALUE, BLOG 

180 1 CONTINUE 

190 10 FORMAT(9HLOG(BASE , F3. 1, 2H ), F6. 2, 

200+3H = .F10.8) 

210 END 



I 
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RNH 



? 4,2 -t 

? 2 

LOG(BASE2.0) 2.00 = 1.00000000 

? 4 

LOG(BASE 2. 0) 4. 00 = 2. 00000000 

? 8 

LOG(BASE 2.0) 8. 00 = 3. 00000000 

LOG (BASE 2. 0) 64. 00 = 6. 00000000 
END. 



■ Input states that there will be four entries for which 
the program will determine the logarithms to the 
base two. 



( 



SS 0.157 SECS. 

RUN COMPLETE. 



SAVE, TEXT=LOGl-«- 
READY. 



The primary file is made an indirect access per- 
- manent file with the name LOG1. This file will 
have a FORTRAN subsystem flag associated with it. 



170 WRITE 10, BASE, VALUE, BLOG He wants to modify the local copy of the program so 

mS[R" that it will write a local file rather than give a 

printout. 

AT LINE NUMBER 170 UNRECOGNIZABLE STATEMENT 
000001 FORTRAN ERRORS IN TEST 

He gets the format wrong. 



SS 0.085 SECS. 

RUN COMPLETE. He realizes that in addition to correcting statement 

170, he must alter the header line to establish a 
120 PROGRAM TEXT (INPUT, TAPE1) local file to write on. He drops the OUTPUT file 

170 WRITE(1, 10) BASE, VALUE, BLOG since there will be no printout. 
RNH 

Input states that there will be three values entered 

for which the program is to determine the logarithms 
to the base eight. 



? 3,8-« 

? 8 
? 64 
? 512 
END. 

SS 0. 164 SECS. 

RUN COMPLETE. 



G-9 



REWIND 1-* He wants to see what he has written on the local 

ILLEGAL COMMAND. file. He remembers to rewind but gets the form 

wrong. 

REWIND, TAPE1 -* -This is right. 



SS 0. 001 SECS. 

READY. 

LNH,F=TAPE1 -+ — Listing gives him what he wanted. 

LOG (BASE 8.0) 8. 00 = 1. 00000000 
LOG(BASE 8.0) 64. 00 = 2. 00000000 
LOG (BASE 8. 0) 512. 00 = 3. 00000000 



SS 0.004 SECS. 

READY. 

SAVE,TEST=LOG2 - < He makes an indirect access permanent file of this 

READY. altered program which he calls LOG2. This file 

will also have a FORTRAN subsystem flag associ- 
ated with it. 



I 



BYE- 



USER123 LOGOFF. 11.10.30. 
USER123 SS 0.870 SEC. 



The user logs off the system. |' 
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PROGRAM CONTROL OF TERMINAL ACTIVITY H 



c 



The user can design an interactive program to control terminal activity in two ways. 

• Include control bytes in his output to control the positioning of the printing 

element, ueimc <xj.uc;i"£iObtc ni^iui. uiuucoj cn- ( 

• Issue a DISTC macro to disable the terminal operator's control of his program 
during critical phase of execution. 

CONTROL BYTES 

A control byte is a 12-bit quantity, right-justified in bit positions 0, 12, 24, 36, and 
48 of a CM word. The following paragraphs describe the bytes available to the user 
and their functions. 

END-OF-LINE (0000) 

This byte generates a carriage return and line feed, positioning the terminal printing 
element at the beginning of the next line. 

END-OF-BLOCK (0001 or 0002) 

This byte prevents the positioning of the terminal printing element at the beginning of the 
next line. An end-of-block byte can be used to allow the terminal operator to enter 
input on the same line as the input request is printed. 

AUTO INPUT (0003) 

This byte is intended for use by the time-sharing executive for auto mode input, but 
the user may include it in his output. The preceding n characters in the word in which 
this byte occurs are also retained as the first n characters of the input line (n must 
be even and less than 9). 

LOG-OFF USER (0004) 

This byte disconnects the terminal user's telephone lines. 

SET TRANSPARENT INPUT MODE (0005) 

This byte changes the input mode from normal or ASCII (refer to section 9) to trans- 
parent mode. A 0005 byte directs the driver to translate all characters to the 6/12 bit 
internal codes as in ASCII mode but to ignore no characters. Also, no input control 
characters except RETURN and INTERRUPT (delete, backspace, STEXT, and ETEXT) 
are processed. -Rather, all characters are passed to the program as data. INTERRUPT 
is passed as NULL followed by END OF LINE. RETURN is- passed as END OF LINE. 
END OF LINE terminates transparent input mode. 



H-l • 



I 



SET BINARY INPUT MODE (0006) 

This byte changes the input mode from normal or ASCII (refer to section 4) to binary mode. The con- 
trol byte must be byte 0. Bytes 1 and 2 are defined as follows: 



Byte 1 Ignored 

Byte 2 Specifies the termination code. The terminator must be one of the three 

following terminators : 



Terminator ASCII Code 

Carriage return (CR) 215 

End-of-text (ETX) 003 

End-of-transmission (EOT) 204 



Terminal Key 

Carriage Return 

CONTROLC 

CONTROL 



WARNING 

In the event that the user either omits a terminator, 
or enters an invalid terminator, the carriage return 
(CR) is the default terminator. 



Four characters (all odd parity) cannot be sent on network ports . 
acters and their associated values: 



The following chart lists the char- 





Odd parity line 


Display code 


ASCII Character 


code 


in octal 
233 


(octal) 


ESC 


7677 


US 




037 


7675 


GS 




235 


7654 


ETB 




227 


7642 



I 



This conversion mode packs the eight bits of data as the lower eight bits of a 12-bit byte and sets the 
upper bit (bit 11). The occurrence of the termination code causes the end-of-line condition to be 
set. A 0007 byte is forced as the first byte of input so the data will be transmitted as binary if it 
is listed. A maximum of 628 characters may be input prior to a terminator code. 



INITIATE BINARY OUTPUT (0007) 

This byte initiates binary output. If the user wishes to output data formatted as described for binary 
input, a 0007 byte must precede the data. This mode continues until another control byte is detected. 

A control byte (0003, 0005, 0006) that changes the terminal input mode prevents the system from 
printing a question mark in response to a program request for input. However, in all other cases, a 
read request on the input buffer causes the system to print a question mark at the terminal. 
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